Mirrors
/
uBlock
mirror of https://github.com/gorhill/uBlock.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
uBlock Origin - An efficient blocker for Chromium and Firefox. Fast and lean.
10,748 Commits 2 Branches 966 Tags 214 MiB
JavaScript 88.6%
CSS 4.8%
HTML 3.4%
WebAssembly 2.4%
Shell 0.6%
Go to file
Raymond Hill cc062d3a8a
No need for redundant "safe" 		2023-04-15 11:14:14 -04:00
.github Fix github-actions re uBO Lite 2023-04-07 13:34:27 -04:00
assets No need for redundant "safe" 2023-04-15 11:14:14 -04:00
dist Make Firefox dev build auto-update 2023-04-14 10:35:45 -04:00
docs Fix typos in README, docs, and JS comments 2022-03-13 08:56:26 -04:00
platform Forcefully clear unprocessed-request status after a minute 2023-04-13 11:41:52 -04:00
src Convert remaining vAPI.setTimeout to vAPI.defer 2023-04-14 10:26:45 -04:00
tools Fix github-actions re uBO Lite 2023-04-07 13:34:27 -04:00
.gitignore git ignore ./tmp/ 2016-04-05 07:55:22 -04:00
.gitmodules Use `git clone` instead of submodule to pull uAssets dependencies 2022-11-14 09:50:53 -05:00
.jshintrc Refactor scriptlets injection code 2023-03-24 14:05:18 -04:00
CONTRIBUTING.md Update CONTRIBUTING.md 2018-04-15 11:52:41 -04:00
LICENSE.txt first commit 2014-06-23 18:42:43 -04:00
MANIFESTO.md Update MANIFESTO.md 2015-03-12 23:22:30 +00:00
Makefile Create a MVP version of uBOLite for Firefox 2023-04-07 10:19:43 -04:00
README.md Update README.md (#3887) 2023-04-15 08:17:21 -04:00
REMOVED.md Added data about old popup panel 2022-11-08 16:53:04 -05:00

README.md

Badge Commits Badge Issues Badge Localization Badge License Badge NPM Badge Mozilla Badge Chrome

uBlock Origin (uBO)

BEWARE! uBO is (and has always been) COMPLETELY UNRELATED to the website ublock.org.

Get uBlock Origin for Firefox Get uBlock Origin for Chromium Get uBlock Origin for Microsoft Edge Get uBlock Origin for Opera

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 after installation 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.

After installation, 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.

uBO uses the EasyList filter syntax and extends the syntax to work with custom rules and filters. Also, uBO has an advanced mode that allows it to work in default-deny mode. This mode will cause all 3rd-party network requests to be blocked by default unless allowed by the user.

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-user mode
Popup user interface A point-and-click firewall that is configurable on a per-site basis

.
.
Configure as you wish.
The image shows 3rd-party scripts and frames blocked by default everywhere.

Visit the Wiki for documentation.

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

Installation

Required Permissions

Chromium

Chrome Web Store

Microsoft Edge Add-ons (Published by: Nicole Rolls)

Opera Add-ons

Development Build

uBO should be compatible with any Chromium-based browser.

Firefox / Firefox for Android

Firefox Add-ons

Development Build

All Browsers

Do NOT use any other similarly-purposed blockers concurrently with uBO to benefit from its higher efficiency. uBO will perform as well as or better than most of the other popular ad blockers. These other blockers can prevent uBO's privacy or anti-blocker-defusing features from working correctly.

Manual Installation

Enterprise Deployment

Deploying uBO

Release History

Releases Page

About

Manifesto

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 were made available to use by all for free.

You can help contribute by translating uBO on Crowdin.

License

GPLv3