lautis0503 / min

A fast, minimal browser that protects your privacy

Min

Min is a fast, minimal browser that protects your privacy. It includes an interface designed to minimize distractions, and features such as:

• Information from DuckDuckGo in the search bar.
• Full-text search for visited pages
• Automatic ad and tracker blocking
• Reader view
• Tasks (tab groups)
• Dark theme

More information, and prebuilt binaries are available here.

Note: Min uses an older version of Chromium, which may be missing security fixes from later versions. More Information

Screenshots

Installing

You can find prebuilt binaries for Min here. Alternatively, skip to the section below for instructions on how to build Min directly from source.

Installation on Linux

• To install the .deb file, use sudo dpkg -i /path/to/download
• To install the RPM build, use sudo rpm -i /path/to/download --ignoreos

Developing

If you want to develop Min:

• Install Node.
• Run npm install to install dependencies.
• Build the translation files and a copy of the JS by running npm run build.
  • You can also watch for changes and automatically rebuild by running npm run watch.
• Start Min by running node_modules/.bin/electron ..¹
• After you make changes, you can press ctrl+r (or cmd+r on Mac) twice to restart the browser.

¹: Make sure no Min instance is already running before starting the development version of Min.

Building binaries

In order to build Min from source, follow the installation instructions above, then use one of the following commands to create binaries:

• npm run buildWindows
• npm run buildMac
• npm run buildDebian
• npm run buildRaspbian (for Raspberry Pi)
• npm run buildRedhat

Depending on the platform you are building for, you may need to install additional dependencies:

• If you are using macOS and building a package for Linux, install Homebrew, then run brew install fakeroot dpkg first.
• If you are using macOS or Linux and building a package for Windows, you will need to install Mono and Wine.

Contributing to Min

Please feel free to open an issue with any problems you encounter or suggestions you have! Code contributions are also highly appreciated; if you have any questions about how to add something to Min, please open an issue about it.

Contributing Translations

Thanks for taking the time to translate Min! If you have any questions about how to add a translation, please open an issue.

Adding a new language

• Find the language code that goes with your language from this list.
• In the localization/languages directory, create a new file, and name it "[your language code].json".
• Open your new file, and copy the contents of the localization/languages/en-US.json file into your new file.
• Change the "identifier" field in the new file to the language code from step 1.
• Inside the file, replace each English string in the right-hand column with the equivalent translation.
• (Optional) See your translations live by following the development instructions above. Min will display in the same language as your operating system, so make sure your computer is set to the same language that you're translating.
• That's it! Make a pull request with your changes.

Updating an existing language

• Find the language file for your language in the localization/languages directory.
• Look through the file for any items that have a value of "null", or that have a comment saying "missing translation".
• For each of these items, look for the item with the same name in the en-US.json file.
• Translate the value from the English file, replace "null" with your translation, and remove the "missing translation" comment.
• Make a pull request with the updated file.