How gorhill/ublock works
uBlock Origin is a browser content blocker: users configure filter lists and site-specific rules, then browser requests and page content are evaluated against those rules to block or modify them. The repository also contains a separate MV3 Lite implementation with ruleset management, filtering modes, and injected scripting. The map preserves those product branches and the dashboard, logger, and picker capabilities. Some source was not sampled; edges are limited to README statements and SOURCE INDEX references, so the unsampled runtime wiring is not inferred.
Main entry points: admin.js Lite administration · storage.js Settings and lists · static-net-filtering.js Network filtering · background.js Background coordinator
Components 24
uBlock Origin
- Dashboard
src/js/dashboard.js - Popup controls
src/js/popup-fenix.js - Filter lists
src/js/3p-filters.js - Site rules
src/js/dynamic-net-filtering.js - Settings and lists
src/js/storage.js - List assets
src/js/assets.js - Background coordinator
src/js/background.js - Request logger
src/js/logger.js - Element picker
src/js/epicker-ui.js
Filtering Runtime
- Filter parser
src/js/static-filtering-parser.js - Network filtering
src/js/static-net-filtering.js - Cosmetic filtering
src/js/cosmetic-filtering.js - Redirect resources
src/js/redirect-engine.js - Page scriptlets
src/js/scriptlet-filtering.js - Dynamic engines
src/js/filtering-engines.js
uBO Lite MV3
- Lite administration
platform/mv3/extension/js/admin.js - Filtering modes
platform/mv3/extension/js/mode-manager.js - Ruleset manager
platform/mv3/extension/js/ruleset-manager.js - Script injection
platform/mv3/extension/js/scripting-manager.js - Custom filter UI
platform/mv3/extension/js/filter-manager-ui.js
Browser Integration
- Extension storage API
platform/mv3/extension/js/ext.js - WebExtension APIs
platform/common/vapi-background.js
Other components
- Browser user
- Browser requests
Connections 25
- Browser user → Popup controls: configures
- Browser user → Dashboard: manages lists
- Dashboard → Filter lists: edits lists
- Filter lists → Settings and lists: saves selection
- Settings and lists → List assets: loads assets
src/js/storage.js - Settings and lists → Filter parser: compiles filters
src/js/storage.js - Background coordinator → Settings and lists: loads filters
src/js/background.js - Background coordinator → Dynamic engines: uses engines
src/js/filtering-engines.js - Browser requests → Background coordinator: dispatches events
- Browser requests → Network filtering: requests evaluated
- Network filtering → Filter parser: uses syntax
- Browser requests → Dynamic engines: site rules evaluated
- Dynamic engines → Site rules: includes firewall
src/js/filtering-engines.js - Cosmetic filtering → Page scriptlets: supports page filtering
- Network filtering → Redirect resources: uses replacements
- Browser user → Request logger: inspects activity
- Browser user → Element picker: selects elements
- Browser user → Lite administration: configures Lite
- Lite administration → Ruleset manager: manages rulesets
platform/mv3/extension/js/admin.js - Lite administration → Filtering modes: sets modes
platform/mv3/extension/js/admin.js - Lite administration → Script injection: manages injection
platform/mv3/extension/js/admin.js - Custom filter UI → Extension storage API: sends changes
platform/mv3/extension/js/filter-manager-ui.js - Filtering modes → Ruleset manager: generates rules
platform/mv3/extension/js/mode-manager.js - Script injection → Ruleset manager: reads rulesets
platform/mv3/extension/js/scripting-manager.js - Extension storage API → WebExtension APIs: uses storage APIs