Skip to content

mchibucos/min

 
 

Repository files navigation

Min

js-standard-style

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

The search bar, showing information from DuckDuckGo

The Tasks Overlay

Reader View

Installing

You can find prebuilt binaries for Min here. Alternatively, you can build Min directly from the source code:

  • If you are using OS X, install Homebrew, then run brew install fakeroot dpkg.
  • Then, run grunt macBuild, grunt linuxBuild, or grunt windowsBuild depending on which platform you want binaries for.

Developing

If you want to develop Min:

  • Install Node and Grunt.
  • 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.
  • Download a copy of Electron from here.
  • Start Min by running node_modules/.bin/electron ..1

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

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! To add translations for your local 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.

Packages

No packages published

Languages

  • JavaScript 69.8%
  • CSS 28.0%
  • HTML 2.2%