Skip to content

r58Playz/uBlock-mv3

 
 

Repository files navigation

uBlock Origin (uBO) MV3 Port

Jump to installation


uBlock Origin (uBO) is a CPU and memory-efficient wide-spectrum content blocker for Chromium and Firefox. It blocks ads, trackers, coin miners, popups, annoying anti-blockers, malware sites, etc., by default using EasyList, EasyPrivacy, Peter Lowe's Blocklist, Online Malicious URL Blocklist, and uBO filter lists. There are many other lists available to block even more. Hosts files are also supported. uBO uses the EasyList filter syntax and extends the syntax to work with custom rules and filters.

You may easily unselect any preselected filter lists if you think uBO blocks too much. For reference, Adblock Plus installs with only EasyList, ABP filters, and Acceptable Ads enabled by default.

It is important to note that using a blocker is NOT theft. Do not fall for this creepy idea. The ultimate logical consequence of blocking = theft is the criminalization of the inalienable right to privacy.

Ads, "unintrusive" or not, are just the visible portion of the privacy-invading means entering your browser when you visit most sites. uBO's primary goal is to help users neutralize these privacy-invading methods in a way that welcomes those users who do not wish to use more technical means.


Documentation

Basic Mode Advanced Mode
The simple popup user interface for an install-it-and-forget-it type of installation that is configured optimally by default. The advanced popup user interface includes a point-and-click firewall that is configurable on a per-site basis.

Visit the Wiki for documentation.

For support, questions, or help, visit /r/uBlockOrigin.

Installation

Add "blockddmmcjpfkbhanlgegpmjpfpfjka;https://ublock.r58playz.dev/update.xml" to your ExtensionInstallForcelist policy.

To do this on Linux:

  1. Create /etc/opt/chrome/policies/managed/policy.json or /etc/chromium/policies/managed/policy.json. (or some other variant depending on your chrome install)
  2. Write { "ExtensionInstallForcelist": ["blockddmmcjpfkbhanlgegpmjpfpfjka;https://ublock.r58playz.dev/update.xml"] } into the file.

Local build:

  1. Clone and make
  2. Load unpacked dist/build/uBlock0.chromium in the extensions UI
  3. Start chrome from the terminal with the command line flag --allowlisted-extension-id=<sideloaded_uBO_id>. You'll need to do this every time.
  4. Enable "Allow User Scripts" in the extension settings
  5. Restart Chrome

CRX build (last resort):

  1. Install the CRX
  2. Start chrome from the terminal with the command line flag --allowlisted-extension-id=<sideloaded_uBO_id>. You'll need to do this every time.
  3. Enable "Allow User Scripts" in the extension settings
  4. Restart Chrome

Issues

  1. Occasionally it tries to inject into a nonexistent frame? No idea what's going on here This looks like it's a browser bug, uBlock Origin Lite has the same issues
  2. Probably some of the MV2 APIs haven't been polyfilled yet so random parts are broken. It seems to be work consistently though

How It Works

  • webRequestBlocking is allowed on MV3 extensions if they are forceinstalled by policy or allowlisted via the command line
  • Polyfilling chrome.tabs.executeScript and chrome.tabs.insertCSS is trivial with chrome.scripting and chrome.userScripts
  • uBO's background page doesn't use many DOM APIs, and polyfilling them is trivial

Release History

Releases Page

Translations

Help translate uBO via Crowdin.

About

Manifesto

Privacy Policy

GPLv3 License

Free. Open-source. For users by users. No donations sought.

If you ever want to contribute something, think about the people working hard to maintain the filter lists you are using, which are available to use by all for free.

About

Full MV3 port of uBlock Origin - An efficient blocker for Chromium and Firefox. Fast and lean.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • JavaScript 88.7%
  • CSS 4.9%
  • HTML 3.5%
  • WebAssembly 2.1%
  • Shell 0.6%
  • Makefile 0.1%
  • Python 0.1%