base on 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: - Full-text search for visited pages - Ad and tracker blocking - Automatic reader view - Tasks (tab groups) - Bookmark tagging - Password manager integration - Dark theme Download Min from the [releases page](https://github.com/minbrowser/min/releases), or learn more on the [website](https://minbrowser.org/). [![Downloads][DownloadsBadge]][DownloadsUrl] [![Discord][DiscordBadge]][DiscordUrl] Min is made possible by these sponsors: | [<img src="https://avatars.githubusercontent.com/u/6592155?v=4" width="40">](https://github.com/blackgwe) | [<img src="https://avatars.githubusercontent.com/u/49724477?v=4" width="40">](https://github.com/rafel-ioli) |[<img src="https://avatars.githubusercontent.com/u/237596?v=4" width="40">](https://github.com/idoru) | | | ----------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |--------------------------------------------------------------------------------------------------------------- | --- | | [@blackgwe](https://github.com/blackgwe) | [@rafel-ioli](https://github.com/rafel-ioli) |[@idoru](https://github.com/idoru) || [Become a sponsor](https://github.com/sponsors/PalmerAL) ## Screenshots <img alt="The search bar, showing information from DuckDuckGo" src="http://minbrowser.org/tour/img/searchbar_duckduckgo_answers.png" width="650"/> <img alt="The Tasks Overlay" src="http://minbrowser.org/tour/img/tasks.png" width="650"/> <img alt="Reader View" src="https://user-images.githubusercontent.com/10314059/53312382-67ca7d80-387a-11e9-9ccc-88ac592c9b1c.png" width="650"/> ## Installing You can find prebuilt binaries for Min [here](https://github.com/minbrowser/min/releases). 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` - On Arch Linux install from [AUR](https://aur.archlinux.org/packages/min-browser-bin). - On Raspberry Pi, you can install Min from [Pi-Apps](https://github.com/Botspot/pi-apps). ## Getting Started * The [wiki](https://github.com/minbrowser/min/wiki) provides an overview of the the features available in Min, a list of available keyboard shortcuts, and answers to some [frequently asked questions](https://github.com/minbrowser/min/wiki/FAQ). * Min supports installing userscripts to extend its functionality. See the [userscript documentation](https://github.com/minbrowser/min/wiki/userscripts) for instructions on writing userscripts, as well as a collection of scripts written by the community. * If you have questions about using Min, need help getting started with development, or want to talk about what we're working on, join our [Discord server](https://discord.gg/bRpqjJ4). ## Developing If you want to develop Min: - Install [Node](https://nodejs.org). - Run `npm install` to install dependencies. - Start Min in development mode by running `npm run start`. - After you make changes, press `alt+ctrl+r` (or `opt+cmd+r` on Mac) to reload the browser UI. ### 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 buildMacIntel` - `npm run buildMacArm` - `npm run buildDebian` - `npm run buildRaspi` (for 32-bit Raspberry Pi) - `npm run buildLinuxArm64` (for 64-bit Raspberry Pi or other ARM Linux) - `npm run buildRedhat` Depending on the platform you are building for, you may need to install additional dependencies: - If you are building a macOS package, you'll need to install Xcode and the associated command-line tools. You may also need to set your default SDK to macOS 11.0 or higher, which you can do by running `export SDKROOT=/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX11.1.sdk`. The exact command will depend on where Xcode is installed and which SDK version you're using. - To build on Windows, you'll need to install Visual Studio. Once it's installed, you may also need to run `npm config set msvs_version 2019` (or the appropriate version). ## Contributing to Min Thanks for taking the time to contribute to Min! ### Getting Help If you're experiencing a bug or have a suggestion for how to improve Min, please open a [new issue](https://github.com/minbrowser/min/issues/new/choose). ### Contributing Code - Start by following the development instructions listed above. - The wiki has an [overview of Min's architecture](https://github.com/minbrowser/min/wiki/Architecture). - Min uses the [Standard](https://github.com/feross/standard) code style; [most editors](https://standardjs.com/#are-there-text-editor-plugins) have plugins available to auto-format your code. - If you see something that's missing, or run into any problems, please open an issue! ### Contributing Translations #### Adding a new language - Find the language code that goes with your language from [this list](https://source.chromium.org/chromium/chromium/src/+/main:ui/base/l10n/l10n_util.cc;l=55) (line 55 - 230). - 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 <a href="https://github.com/minbrowser/min/blob/master/localization/languages/en-US.json">localization/languages/en-US.json</a> 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](#installing) 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. [DiscordBadge]: https://img.shields.io/discord/764269005195968512.svg?label=Discord&logo=discord&logoColor=white [DiscordUrl]: https://discord.gg/bRpqjJ4 [DownloadsBadge]: https://img.shields.io/github/downloads/minbrowser/min/total.svg [DownloadsUrl]: https://github.com/minbrowser/min/releases ", Assign "at most 3 tags" to the expected json: {"id":"9718","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"