Bromite is a Chromium fork with ad blocking and privacy enhancements; take back your browser!
GPL-3.0 License
Bromite is a Chromium fork with support for ad blocking and enhanced privacy.
Bromite is only available for Android Marshmallow (v6.0, API level 23) and above.
For the Frequently Asked Questions see F.A.Q..
For documentation see the wiki.
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".
Please donate to support development of Bromite and the costs for the build system.
Patreon: https://www.patreon.com/csagan5
BTC donations address: bc1qlx7h0lj9z88g2xfeuwsrtfs77sxuhrxf2t28sw
ETH donations address: 0x5d392F8FBf3465afe05B1Adc575e248D33B891F6
PartitionConnectionsByNetworkIsolationKey
, PartitionHttpServerPropertiesByNetworkIsolationKey
, SplitHostCacheByNetworkIsolationKey
, AppendFrameOriginToNetworkIsolationKey
, SplitCacheByNetworkIsolationKey
, UseRegistrableDomainInNetworkIsolationKey
, PartitionSSLSessionsByNetworkIsolationKey
, PartitionExpectCTStateByNetworkIsolationKey
, PartitionDomainReliabilityByNetworkIsolationKey
)view-source:
URLsSegmentationPlatformFeature
, OptimizationHints
, client hint headersAsyncDNS
by defaultview-source:
URLsYou can inspect all functionality/privacy changes by reading the patches and/or the CHANGELOG.
Flags which have been retired from upstream Chromium but are still available in Bromite.
#pull-to-refresh
#enable-search-ready-omnibox
#darken-websites-checkbox-in-themes-setting
#simplified-ntp
, enabled by default#enable-text-fragment-anchor
, disabled by default#num-raster-threads
#enable-image-reader
, enabled by default#enable-tab-groups
and #enable-tab-groups-ui-improvements
#offline-indicator-v2
New flags:
#fingerprinting-canvas-image-data-noise
, #fingerprinting-client-rects-noise
and #fingerprinting-canvas-measuretext-noise
, enabled by default#incognito-screenshot
, disabled by default#max-connections-per-host
#resume-background-video
#ipv6-probing
#enable-device-motion
and #enable-device-orientation
#show-legacy-tls-warnings
#save-data-header
, disabled by default#export-bookmarks-use-saf
, disabled by default#allow-user-certificates
, disabled by default#cleartext-permitted
, enabled by default, can be used to disable all cleartext-HTTP traffic#omnibox-autocomplete-filtering
, can be used to restrict omnibox autocomplete results#disable-external-intent-requests
, can be used to disable opening any external app for any URL#enable-userscripts-log
, see https://github.com/bromite/bromite/wiki/UserScripts#flags
#certificate-transparency-enabled
, enabled by default; see https://chromium.googlesource.com/chromium/src/+/master/net/docs/certificate-transparency.md
#move-top-toolbar-to-bottom
, disabled by default#site-engagement
, enabled by default#offline-pages-auto-save
, disabled by default, allows auto-saving of pages when device goes offline#adaptive-button-in-top-toolbar-customization
, disabled by default, allows having a new tab or share button on the address barBromite's privacy features, including anti-fingerprinting mitigations (which are not comprehensive), are not to be considered useful for journalists and people living in countries with freedom limitations, please look at Tor Browser in such cases.
All built versions are available as releases; the official website points to those releases and - when browsing via Android - it will automatically highlight 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 version 23+; Bromite SystemWebView is provided as well (SDK23+). 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.
You will automatically receive notifications about new updates (and be able to install them) via the auto updater functionality (enabled by default), see related wiki page.
All official releases are also available through the official third-party F-Droid repository.
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
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 <[email protected]>"
You can download csagan5's public GnuPG key from here: csagan5.asc.
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 Chromium version tag used as base for the patches is available here: RELEASE; this is always corresponding to the git tag for every release.
The GN args used to build Bromite are available here: bromite.gn_args.
The patches are to be applied second the order specified in the bromite_patches_list.txt
file (you can use git am
).
NOTE: no official support is provided for builds.
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
Please submit issues following the issue template; beware that GitHub does not display the templates from mobile.
Patches are welcome and accepted if they match the project goals.
For any usage or development discussion please use GitHub Discussions: https://github.com/bromite/bromite/discussions
The URLs of the lists used are available at: https://github.com/bromite/filters/blob/master/lists.txt
The patches published as part of the Bromite project are released under GNU GPL v3.