Skip to content
 
 

Repository files navigation

Warning

Still under construction; the official version is recommended for now.

uBOL Expanded

uBOL Expanded (uBOL-Exp) is an independent fork of uBO Lite which is an efficient, MV3-based content blocker by Raymond Hill. This fork bundles extra AdGuard filter lists on top of the standard uBO Lite defaults, with no extra CPU or memory cost.

What's Different from uBO Lite

The default ruleset includes at least uBlock Origin's default filter set:

  • uBlock Origin's built-in filter lists
  • EasyList
  • EasyPrivacy
  • Peter Lowe's Ad and tracking server list

On top of that, uBOL-Exp adds these optional filter lists you can enable in the options page:

  • AdGuard Base filter: broader ad blocking coverage
  • AdGuard Tracking Protection: extended tracker blocking
  • AdGuard Annoyances: cookie banners, popups, and other annoyances

AdGuard lists are mutually exclusive with their EasyList equivalents. Enabling one automatically disables the other to avoid any potential rule conflicts.

How It Works

uBOL-Exp operates entirely declaratively using the MV3 API, meaning no permanent background process is required for filtering. The browser handles CSS/JS injection for content filtering, ensuring uBOL-Exp does not consume CPU or memory while blocking content. The service worker process is only active when interacting with the popup panel or options pages.

You can enable or disable rulesets by visiting the options page; click the Cogs icon in the popup panel.

Installation

Firefox

Available on the Firefox Add-ons Store (AMO).

Chromium (Chrome, Edge, Brave, etc.)

Download the latest .chromium.zip release from the Releases page and load it unpacked in developer mode.

Changelog

See the Releases section.

Older upstream releases: Wiki/Release notes (salvaged).

Issues & Support

  • Extension bugs: Report at the GitHub Issues page.
  • Filter issues (ads not blocked, site breakage, tracker detection, etc.): Report via the Chat icon in uBOL while on the affected site.
  • Questions: Ask in Discussions.

Admin Policies

uBOL-Exp exposes settings that can be defined by administrators through managed storage. See Managed settings.

FAQ

See the upstream FAQ, most answers apply here too.

Credits

This project is an independent fork released under GPLv3.

About

[WORK IN PROGRESS] uBOL Expanded - Efficient adblocker for Chromium and Firefox with expanded filter coverage.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages