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

Skip to content
README.md 4.37 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
<img src="https://www.bromite.org/bromite_bromite_gh_downloads.svg" alt="downloads on Github" title="downloads on Github" /> <img src="https://www.bromite.org/bromite_bromite_xda_downloads.svg" alt="downloads on XDA Labs" title="downloads on XDA Labs" />
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
# F.A.Q.

## Does Google Sync/Translate/Data saver work?
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.

Carl's avatar
Carl committed
## What is the SystemWebView?
It is the core component of Android for all web page visualizations. For example when you access a new wifi network and need to activate it, that is using the SystemWebView. If you do not know what it is then you do not need to install it.

csagan5's avatar
csagan5 committed
## Does Bromite require root?
No.

Carl's avatar
Carl committed
## Can you add dark mode/some cool themes?
Carl's avatar
Carl committed
No.
Bromite is about adblocking and privacy.

## Can you add HTTPS everywhere?
No.
We cannot add add-ons to Bromite (merely some features) and anyway HTTPS everywhere in particular is too invasive to be easily maintained across new releases.

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
* [DuckDuckGo](https://duckduckgo.com/) search engine
* [Qwant](https://www.qwant.com/) search engine
* Google search engines English-only with reduced tracking
csagan5's avatar
csagan5 committed
* privacy enhancement patches from Inox patchset, ungoogled-chromium and Iridium projects
csagan5's avatar
csagan5 committed
* removed webRTC and applied other anti-fingerprinting mitigations
csagan5's avatar
csagan5 committed
* all codecs included (proprietary, open H.264 etc.)
csagan5's avatar
csagan5 committed
* built with official optimizations
csagan5's avatar
csagan5 committed

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