Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Skip to content
README.md 3.57 KiB
Newer Older
csagan5's avatar
csagan5 committed
# Bromite - Take back your browser

csagan5's avatar
csagan5 committed
[![GitHub release][version-image]][version-url] [![license][license-image]][license-url]
csagan5's avatar
csagan5 committed

csagan5's avatar
csagan5 committed
<img title="Bromite - take back your browser!" src="https://www.bromite.org/android-icon-192x192.png" width="96" alt="Bromite" />
csagan5's avatar
csagan5 committed

csagan5's avatar
csagan5 committed
Bromite is [Chromium](https://www.chromium.org/Home) plus some patches for ad blocking and enhanced privacy.
csagan5's avatar
csagan5 committed

Bromite is only available for Android v4.1 and above.
csagan5's avatar
csagan5 committed
See [open issues](https://github.com/bromite/bromite/issues) for the development in progress.
csagan5's avatar
csagan5 committed

csagan5's avatar
csagan5 committed
# Donate

Please donate to support development of Bromite and the costs for the build system.

csagan5's avatar
csagan5 committed
Support development with a donation of 3 EUR: [![paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=JP3XTQPVRNET2)
csagan5's avatar
csagan5 committed

csagan5's avatar
csagan5 committed
Support development with a free amount donation: [![paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=LC7Q6A3UAQPY8)
csagan5's avatar
csagan5 committed

BTC donations address: `3MkC3idL61npQSCxL1gceksmRTkNkiCPcG`

ETH donations address: `0xf47ff39223d828f99fec5ab53bd068c5c0522042`

csagan5's avatar
csagan5 committed
# Features

* adblocking (currently baked-in, no configuration options available)
* remove click-tracking and AMP from Google search results
csagan5's avatar
csagan5 committed
* allow youtube/vimeo videos to play in background
csagan5's avatar
csagan5 committed
* [StartPage](https://startpage.com/) search engine (select it from search engines under settings)
csagan5's avatar
csagan5 committed
* [DuckDuckGo](https://duckduckgo.com/) search engine (select it from search engines under settings)
csagan5's avatar
csagan5 committed
* Google search engines English-only with reduced tracking (select it from search engines under settings)
csagan5's avatar
csagan5 committed
* privacy enhancement patches from Inox patchset, ungoogled-chromium and Iridium projects
* all codecs included (proprietary, open H.264 etc.)
csagan5's avatar
csagan5 committed
* built with official optimizations
csagan5's avatar
csagan5 committed

# F.A.Q.

csagan5's avatar
csagan5 committed
## Does Google Sync/Translate/Data saver work?
csagan5's avatar
csagan5 committed
No.
This is not a limitation of Bromite but of all Chromium-based projects in general, as general public is not allowed to use Google's APIs for free unless when using Chrome.

csagan5's avatar
csagan5 committed
# Releases

A build server goes through the very lengthy build operation and then new versions are available in this project as [releases](https://github.com/bromite/bromite/releases).

Each tag corresponds to a Chromium release tag.

csagan5's avatar
csagan5 committed
# How to build

The [bromite main repository](https://github.com/bromite/bromite) contains tags for each corresponding Chromium release (see https://chromium.googlesource.com/chromium/src.git).

Please refer to [official Chromium build documentation](https://www.chromium.org/developers/how-tos/get-the-code) to get started on how to build Chromium; if you can build Chromium for Android, you can build Bromite.

csagan5's avatar
csagan5 committed
# Credits

csagan5's avatar
csagan5 committed
* [Chromium project](https://www.chromium.org/Home) and developers
csagan5's avatar
csagan5 committed
* [ungoogled-chromium](https://github.com/Eloston/ungoogled-chromium) for some patches
csagan5's avatar
csagan5 committed
* [Iridium project](https://github.com/iridium-browser) for some patches (taken from above ungoogled-chromium)
csagan5's avatar
csagan5 committed
* [Inox patchset](https://github.com/gcarq/inox-patchset) for some patches (taken from above ungoogled-chromium)
* nochromo for the original adblock patch
* AdBlock Plus, uBlock, EasyList and EasyPrivacy for the compilation of original adblock patch
csagan5's avatar
csagan5 committed

# License

csagan5's avatar
csagan5 committed
The patches published as part of the Bromite project are released under [GNU GPL v3](./LICENSE).
csagan5's avatar
csagan5 committed

[version-image]: https://img.shields.io/github/release/bromite/bromite.svg?style=flat-square
[version-url]: https://github.com/bromite/bromite/releases/latest
csagan5's avatar
csagan5 committed
[license-image]: https://img.shields.io/github/license/bromite/bromite.svg
[license-url]: https://github.com/bromite/bromite/blob/master/LICENSE