/bromite

Bromite is Chromium plus ad blocking and privacy enhancements; take back your browser!

GNU General Public License v3.0GPL-3.0

Bromite - Take back your browser

current Bromite release GNU GPL v3

Bromite

Bromite is Chromium plus some patches for ad blocking and enhanced privacy.

Bromite is only available for Android v4.4 and above.

downloads on Github

Goals

Bromite aims at providing a no-clutter browsing experience without privacy-invasive features and with the addition of a fast ad-blocking engine. Minimal UI changes are applied to help curbing the idea of "browser as an advertisement platform".

Donate

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

→ Support development with a donation: paypal

BTC donations address: 3MkC3idL61npQSCxL1gceksmRTkNkiCPcG

ETH donations address: 0xf47ff39223d828f99fec5ab53bd068c5c0522042

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.

Additionally, these features would not be privacy-friendly.

Does Bromite require root?

No.

Is Bromite de-googled?

Yes, although this has not been verified (and hardly can be) under all situations; if you were to find connections to cloud-based services please report them via the issue tracker. Projects which follow a strict approach on this are Iridium and Inox patchset.

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.

See also the wiki page for community-contributed installation instructions.

How to enable DNS-over-HTTPS?

See this wiki page.

Can you add HTTPS everywhere?

No. We cannot add add-ons to Bromite (merely some features).

Is Bromite on Play Store?

No, and this is unlikely to change. Many limitations apply for submissions there, including which ads are allowed to be blocked.

Bromite favors user freedom in software choice: the device is yours so you get to choose which software to run on it, end of the story.

Is Bromite on F-Droid?

It is not on the official F-Droid repository and there are no (more) plans to submit it.

You can use F-Droid client to install and receive updates via the official Bromite F-Droid repository.

Does Bromite support WebRTC?

Yes, since version 69. While the desktop version of Chromium has an option to disable it (video/audio site settings), the Android version cannot.

Features

  • native adblock engine
  • remove click-tracking and AMP from search results
  • DNS-over-HTTPS support via Google, Cloudflare, Quad9 and AdGuard servers
  • proxy configuration page with PAC and custom proxy lists support
  • StartPage, DuckDuckGo and Qwant search engines
  • chrome flags to disable custom intents and clear session on exit
  • always-incognito mode
  • completely removed safe browsing and other privacy-unfriendly features
  • anti-fingerprinting mitigations for canvas, audio, client rects, webGL and sensor APIs
  • use fixed User-Agent to conceal real model and browser version
  • privacy enhancement patches from Iridium, Inox patchset, Brave and ungoogled-chromium projects
  • security enhancement patches from GrapheneOS project

Features not related to privacy

  • import/export bookmarks
  • allow playing videos in background tabs and disable pause on switching tabs
  • all codecs included (proprietary, open H.264 etc.)
  • AV1 codec support
  • built with official speed optimizations

You can inspect all functionality/privacy changes by reading the patches: https://github.com/bromite/bromite/tree/master/build/patches

Privacy limitations

Bromite's privacy features, including anti-fingerprinting mitigations (which can be easily circumvented), are not to be considered useful for journalists and people living in countries with freedom limitations, please look at Tor Browser in such cases.

Releases

All built versions are available as releases; the official website points to those releases and - when browsing via Android - it will automatically select the one apt for your device (or none otherwise).

Each tag corresponds to a Chromium Stable release tag.

Bromite is currently built for ARM, ARM64 and x86 and for the Android SDK versions 19 and 21; Bromite SystemWebView is provided as well (SDK21+). For every Bromite build you can always find a matching vanilla Chromium build which is used for example to verify which issues are specific to Bromite or not.

All official releases are also available through the official third-party F-Droid repository.

Integrity and authenticity

You can verify the integrity of a downloaded APK file from this project with any sha256sum-compatible tool by downloading the corresponding brm_X.Y.Z.sha256.txt or chr_X.Y.Z.sha256.txt file, where X.Y.Z is the release version number. Example:

$ sha256sum --check brm_68.0.3440.54.sha256.txt
arm64_SystemWebView.apk: OK
arm64_ChromePublic.apk: OK
arm64_ChromeModernPublic.apk: OK

If you prefer an UI-based tool, you might want to look into GtkHash.

You can verify authenticity, e.g. that the author (csagan5) released the file, by using gpg2:

$ gpg2 --quiet --verify brm_68.0.3440.54.sha256.txt.asc
gpg: assuming signed data in 'brm_68.0.3440.54.sha256.txt'
gpg: Signature made Sun 08 Jul 2018 04:22:52 PM CEST using RSA key ID D85DC0C5
gpg: Good signature from "csagan5 <32685696+csagan5@users.noreply.github.com>"

You can download csagan5's public GnuPG key from here: csagan5.asc.

NOTE: releases before v68 did not have published signed hashes files.

How to build

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

Please refer to official Chromium build documentation to get started on how to build Chromium; if you can build Chromium for Android, you can build Bromite.

The GN args used to build Bromite are available here: GN_ARGS. The patches are to be applied second the order specified in the bromite_patches_list.txt file (you can use git am).

How to build the filters

See upstream documentation: https://github.com/chromium/chromium/blob/master/components/subresource_filter/FILTER_LIST_GENERATION.md

Bromite uses an unindexed filter file, which is periodically published at https://github.com/bromite/filters

Credits

Filters credits

License

The patches published as part of the Bromite project are released under GNU GPL v3.