Skip to content

PrimaelQuemerais/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, skip to the section below for instructions on how to build Min directly from source.

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 ..1
  • After you make changes, you can press ctrl+r (or cmd+r on Mac) twice to restart the browser.

1: 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 buildLinux

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! 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.

About

A fast, minimal browser that protects your privacy

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 68.6%
  • CSS 29.0%
  • HTML 2.4%