Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/uBlockOrigin/uBOL-home
uBO Lite home (MV3)
https://github.com/uBlockOrigin/uBOL-home
Last synced: about 1 month ago
JSON representation
uBO Lite home (MV3)
- Host: GitHub
- URL: https://github.com/uBlockOrigin/uBOL-home
- Owner: uBlockOrigin
- License: gpl-3.0
- Created: 2022-09-29T13:35:21.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-28T17:09:23.000Z (about 2 months ago)
- Last Synced: 2024-10-28T17:28:56.263Z (about 2 months ago)
- Language: JavaScript
- Homepage:
- Size: 133 MB
- Stars: 1,155
- Watchers: 25
- Forks: 47
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - uBlockOrigin/uBOL-home - uBO Lite home (MV3) (JavaScript)
README
# uBO Lite
Frequently asked questions (FAQ)
## Description
**uBO Lite** (uBOL) is a **permission-less** content blocker based on the [MV3 API](https://developer.chrome.com/docs/extensions/develop/migrate/what-is-mv3).
uBOL operates entirely declaratively, meaning no permanent process is required for filtering. The browser handles CSS/JS injection for content filtering, ensuring that uBOL does not consume CPU or memory resources while blocking content. The service worker process is only active when interacting with the popup panel or options pages.
uBOL does not require broad "read/modify data" [permissions](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/permissions) at install time, limiting its capabilities compared to uBlock Origin or other content blockers that need such permissions upfront.
**However**, users can *explicitly* grant extended permissions for specific sites to enhance filtering using declarative cosmetic and scriptlet injections.
To grant permissions on a given site, open the popup panel and select a higher filtering mode like Optimal or Complete.
The browser will alert you to the implications of granting additional permissions, and you must decide whether to accept or decline:
If you accept the request, uBOL can better filter content on the current site:
You can set the default filtering mode from uBOL's options page. If you choose Optimal or Complete as the default, you will need to grant uBOL permission to modify and read data on all websites:
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
You can enable additional rulesets by visiting the options page — click the _Cogs_ icon in the popup panel.
Please note that this is still a work in progress, with the following goals:
- No broad host permissions at install time — extended permissions are granted explicitly by the user on a per-site basis.
- Entirely declarative for reliability and CPU/memory efficiency.
## Changelog
See the [_Releases_ section](https://github.com/uBlockOrigin/uBOL-home/releases).
Previous releases can be found in the [_Releases_ section of the uBlock repo](https://github.com/gorhill/uBlock/releases?q=uBOL).
## Issues
All uBO Lite-related issues (including filter-related ones) can be reported [here](https://github.com/uBlockOrigin/uBOL-home/issues).
## Admin Policies
uBOL exposes settings that can be defined by administrators through [managed storage](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/storage/managed). See [Managed settings](https://github.com/uBlockOrigin/uBOL-home/wiki/Managed-settings).
## Frequently Asked Questions (FAQ)
For more information, check the [_Wiki_](https://github.com/uBlockOrigin/uBOL-home/wiki/Frequently-asked-questions-(FAQ)).