1
0
mirror of https://github.com/gorhill/uBlock.git synced 2024-07-08 04:49:12 +02:00
uBlock/README.md

197 lines
9.9 KiB
Markdown
Raw Normal View History

2022-04-30 02:37:56 +02:00
[![Badge Commits]][Commit Rate]
[![Badge Issues]][Issues]
[![Badge Localization]][Crowdin]
[![Badge License]][License]
[![Badge NPM]][NPM]
[![Badge Mozilla]][Mozilla]
[![Badge Chrome]][Chrome]
2015-05-27 13:15:51 +02:00
***
2015-04-04 13:34:38 +02:00
<h1 align="center">
<sub>
2022-11-02 18:39:45 +01:00
<img src="https://github.com/gorhill/uBlock/blob/master/src/img/ublock.svg" height="38" width="38">
</sub>
2022-11-02 18:39:45 +01:00
uBlock Origin (uBO)
</h1>
<p align="center">
2022-11-02 18:39:45 +01:00
<sup>
Pronounced <i>you-block origin</i> (<code>/ˈjuːˌblɒk/</code>). <i>You</i> decide what enters your browser.
2015-03-08 01:53:01 +01:00
</sup>
<br>
2022-11-02 18:39:45 +01:00
<sub><a href="https://github.com/gorhill/uBlock/wiki/uBlock-Origin-is-completely-unrelated-to-the-web-site-ublock.org"><b>BEWARE!</b> uBO is (and has always been) COMPLETELY UNRELATED to the website <code>ublock.org</code></a>.</sub>
</p>
***
<p align="center">
<a href="https://addons.mozilla.org/addon/ublock-origin/"><img src="https://user-images.githubusercontent.com/585534/107280546-7b9b2a00-6a26-11eb-8f9f-f95932f4bfec.png" alt="Get uBlock Origin for Firefox"></a>
<a href="https://chrome.google.com/webstore/detail/ublock-origin/cjpalhdlnbpafiamejdnhcphjbkeiagm"><img src="https://user-images.githubusercontent.com/585534/107280622-91a8ea80-6a26-11eb-8d07-77c548b28665.png" alt="Get uBlock Origin for Chromium"></a>
<a href="https://microsoftedge.microsoft.com/addons/detail/ublock-origin/odfafepnkmbhccpbejgmiehpchacaeak"><img src="https://user-images.githubusercontent.com/585534/107280673-a5ece780-6a26-11eb-9cc7-9fa9f9f81180.png" alt="Get uBlock Origin for Microsoft Edge"></a>
<a href="https://addons.opera.com/extensions/details/ublock/"><img src="https://user-images.githubusercontent.com/585534/107280692-ac7b5f00-6a26-11eb-85c7-088926504452.png" alt="Get uBlock Origin for Opera"></a>
</p>
2017-10-21 14:55:19 +02:00
***
2022-11-02 18:39:45 +01:00
uBO is **NOT** an "ad blocker"; it is a [wide-spectrum content blocker][Blocking] for Chromium and Firefox with CPU and memory efficiency as primary features. When newly installed, the default behavior of uBO is to block ads, trackers, and malware sites through [EasyList][EasyList], [EasyPrivacy][EasyPrivacy], [Peter Lowe's Blocklist][Peter Lowe's Blocklist], [Online Malicious URL Blocklist][Malicious Blocklist], and uBO's [filter lists][uBO Filters].
2017-10-21 14:55:19 +02:00
***
2015-03-27 21:21:31 +01:00
* [Documentation](#documentation)
2015-08-07 00:58:51 +02:00
* [Purpose & General Info](#philosophy)
* [Installation](#installation)
2015-11-09 17:06:59 +01:00
* [Chromium](#chromium)
2022-11-02 18:39:45 +01:00
* [Firefox](#firefox--firefox-for-android--firefox-legacy)
* [Release History](#release-history)
2022-11-02 18:39:45 +01:00
* [Privacy Policy]
* [Wiki](https://github.com/gorhill/uBlock/wiki)
2014-06-23 02:00:34 +02:00
2015-08-07 00:48:47 +02:00
## Documentation
Basic mode | Advanced-user mode
:----------:|:------------------:
2022-11-02 18:39:45 +01:00
[Popup user interface] | [A point-and-click firewall that is configurable on a per-site basis][Dynamic Filters]
<a href="https://github.com/gorhill/uBlock/wiki/Quick-guide:-popup-user-interface"><img src="https://user-images.githubusercontent.com/585534/84045360-b10ee580-a976-11ea-9e91-29c2107b47c2.png"/></a><br><sup>.<br>.</sup> | <a href="https://github.com/gorhill/uBlock/wiki/Dynamic-filtering:-quick-guide"><img src="https://user-images.githubusercontent.com/585534/84045366-b1a77c00-a976-11ea-9121-e8c8f35c66c8.png"/></a><br><sup>Configure as you wish.<br>The image shows 3rd-party scripts and frames blocked by default everywhere.</sup>
2015-08-07 00:48:47 +02:00
2022-11-02 18:39:45 +01:00
Visit the [wiki][Wiki] for documentation.
2015-08-07 00:48:47 +02:00
2022-11-02 18:39:45 +01:00
For any support, questions or help, visit [/r/uBlockOrigin][Reddit].
2017-07-09 01:48:05 +02:00
2015-01-17 04:43:37 +01:00
## Philosophy
2014-09-19 16:16:34 +02:00
2022-11-02 18:39:45 +01:00
uBO is **NOT** an "ad blocker"; it is a wide-spectrum content blocker. uBO blocks ads through the EasyList filter syntax and [extends][Extended Syntax] the syntax to work with custom rules and filters. Furthermore, the advanced mode allows uBO to work in [default-deny mode][Default Deny], which will cause [all 3rd-party network requests][3rd Party Requests] to be blocked by default unless allowed by the user.
2014-09-19 16:16:34 +02:00
2022-11-02 18:39:45 +01:00
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.
2014-09-19 16:16:34 +02:00
2022-11-02 18:39:45 +01:00
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, involved means (such as [uMatrix]).
2022-11-02 18:39:45 +01:00
EasyList, EasyPrivacy, Peter Lowe's Blocklist, Online Malicious URL Blocklist, and uBO's filter lists are enabled by default when you install uBO. Many other lists are available to block trackers, analytics, and more. Hosts files are also supported.
2022-11-02 18:39:45 +01:00
Once you install uBO, 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.
2015-02-26 16:00:27 +01:00
2014-06-23 02:00:34 +02:00
## Installation
2022-11-02 18:39:45 +01:00
[Required Permissions][Permissions]
2015-01-17 04:47:40 +01:00
#### Chromium
2022-11-02 18:39:45 +01:00
[Chrome Web Store][Chrome]
2017-10-02 13:41:14 +02:00
2022-11-02 18:39:45 +01:00
[Microsoft Edge Add-ons][Edge] (Published by: [Nicole Rolls][Nicole Rolls])
2015-12-12 15:06:31 +01:00
2022-11-02 18:39:45 +01:00
[Opera Add-ons][Opera]
2022-11-02 18:39:45 +01:00
[Manual Installation][Manual Installation]
2017-10-02 13:42:53 +02:00
2022-11-02 18:39:45 +01:00
[Development Build][Chrome Dev]
2015-12-12 15:01:54 +01:00
2022-11-02 18:39:45 +01:00
uBO should be compatible with any Chromium-based browser.
2022-11-02 18:39:45 +01:00
#### Firefox / Firefox for Android / Firefox Legacy
2022-11-02 18:39:45 +01:00
[Firefox Add-ons][Mozilla]
2022-11-02 18:39:45 +01:00
[Development Build][Beta]
2022-11-02 18:39:45 +01:00
[uBO Firefox Legacy][Firefox Legacy]
2016-08-08 19:48:04 +02:00
2022-11-02 18:39:45 +01:00
uBO Firefox Legacy should be compatible with [SeaMonkey], [Pale Moon], or any other browsers based on Firefox.
2016-12-15 19:41:38 +01:00
2022-11-02 18:39:45 +01:00
[Debian Package][Debian Package]
2018-01-04 20:51:33 +01:00
2022-11-02 18:39:45 +01:00
uBO also can be installed as a Debian package.
2016-12-07 16:05:29 +01:00
2022-11-02 18:39:45 +01:00
- Firefox 56-: `apt-get install xul-ext-ublock-origin`
- Firefox 55+: `apt-get install webext-ublock-origin`
2022-11-02 18:39:45 +01:00
There is no guarantee that the package will be available on your specific platform, in which case, you will have to install it from [Firefox Add-ons][Mozilla].
2018-01-04 20:51:33 +01:00
2022-11-02 18:39:45 +01:00
#### All Browsers
2014-06-23 02:00:34 +02:00
2022-11-02 18:39:45 +01:00
Do **NOT** use any other content blocker concurrently with uBO to benefit from uBO's higher efficiency. uBO will [perform][Performance] as well as or better than most of the other popular ad blockers. Other blockers can prevent uBO's privacy or anti-blocker-defusing features from working correctly.
2014-06-24 06:38:26 +02:00
2022-11-02 18:39:45 +01:00
Do **NOT** use uBO along with other [similarly-purposed blockers][Similarly-Purposed].
2017-10-02 13:49:23 +02:00
2022-11-02 18:39:45 +01:00
#### Enterprise Deployment
2017-10-02 13:49:23 +02:00
2022-11-02 18:39:45 +01:00
[Deploying uBO][Deployment]
2017-10-02 13:49:23 +02:00
## Release History
2022-11-02 18:39:45 +01:00
[Releases Page][Releases]
2014-07-30 00:07:36 +02:00
2014-06-23 02:00:34 +02:00
## About
2022-11-02 18:39:45 +01:00
[Manifesto][Manifesto]
2014-08-26 00:51:39 +02:00
Free. Open source. For users by users. No donations sought.
2022-11-02 18:39:45 +01:00
Without the preset filter lists, this extension is nothing. 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.
2022-11-02 18:39:45 +01:00
You can help contribute by translating uBO on [Crowdin].
2014-07-05 22:03:59 +02:00
2014-06-23 02:00:34 +02:00
## License
2022-11-02 18:39:45 +01:00
[GPLv3][License]
2022-04-30 02:37:56 +02:00
<!----------------------------------------------------------------------------->
2022-11-02 18:39:45 +01:00
[Peter Lowe's Blocklist]: https://pgl.yoyo.org/adservers/
[Malicious Blocklist]: https://gitlab.com/malware-filter/urlhaus-filter#malicious-url-blocklist
2022-04-30 02:37:56 +02:00
[3rd Party Requests]: https://requestpolicycontinued.github.io/#what-are-cross-site-requests
2022-11-02 18:39:45 +01:00
[Similarly-Purposed]: https://twitter.com/gorhill/status/1033706103782170625
2022-04-30 02:37:56 +02:00
[Debian Package]: https://packages.debian.org/stable/source/ublock-origin
[Performance]: https://www.debugbear.com/blog/chrome-extension-performance-2021#how-do-ad-blockers-and-privacy-tools-affect-browser-performance
2022-11-02 18:39:45 +01:00
[EasyPrivacy]: https://easylist.to/#easyprivacy
[Chrome Dev]: https://chrome.google.com/webstore/detail/ublock-origin-development/cgbcahbpdhpcegmbfconppldiemgcoii
2022-04-30 02:37:56 +02:00
[SeaMonkey]: https://www.seamonkey-project.org/
[Pale Moon]: https://www.palemoon.org/
2022-11-02 18:39:45 +01:00
[EasyList]: https://easylist.to/#easylist
[Mozilla]: https://addons.mozilla.org/addon/ublock-origin/
2022-04-30 02:37:56 +02:00
[Crowdin]: https://crowdin.com/project/ublock
[Chrome]: https://chrome.google.com/webstore/detail/ublock-origin/cjpalhdlnbpafiamejdnhcphjbkeiagm
[Reddit]: https://www.reddit.com/r/uBlockOrigin/
[Theft]: https://twitter.com/LeaVerou/status/518154828166725632
[Opera]: https://addons.opera.com/extensions/details/ublock/
[Edge]: https://microsoftedge.microsoft.com/addons/detail/ublock-origin/odfafepnkmbhccpbejgmiehpchacaeak
[NPM]: https://www.npmjs.com/package/@gorhill/ubo-core
[Manifesto]: MANIFESTO.md
[License]: LICENSE.txt
2022-11-02 18:39:45 +01:00
[Nicole Rolls]: https://github.com/nicole-ashley
2022-04-30 02:37:56 +02:00
<!---------------------------------[ Internal ]-------------------------------->
[Popup User Interface]: https://github.com/gorhill/uBlock/wiki/Quick-guide:-popup-user-interface
[Manual Installation]: https://github.com/gorhill/uBlock/tree/master/dist#install
[Extended Syntax]: https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#extended-syntax
[Dynamic Filters]: https://github.com/gorhill/uBlock/wiki/Dynamic-filtering:-quick-guide
2022-11-02 18:39:45 +01:00
[Firefox Legacy]: https://github.com/gorhill/uBlock-for-firefox-legacy
2022-04-30 02:37:56 +02:00
[Privacy Policy]: https://github.com/gorhill/uBlock/wiki/Privacy-policy
[Default Deny]: https://github.com/gorhill/uBlock/wiki/Dynamic-filtering:-default-deny
2022-11-02 18:39:45 +01:00
[uBO Filters]: https://github.com/uBlockOrigin/uAssets/tree/master/filters
2022-04-30 02:37:56 +02:00
[Permissions]: https://github.com/gorhill/uBlock/wiki/Permissions
[Commit Rate]: https://github.com/gorhill/uBlock/commits/master
2022-11-02 18:39:45 +01:00
[Deployment]: https://github.com/gorhill/uBlock/wiki/Deploying-uBlock-Origin
2022-04-30 02:37:56 +02:00
[Blocking]: https://github.com/gorhill/uBlock/wiki/Blocking-mode
[Releases]: https://github.com/gorhill/uBlock/releases
[UMatrix]: https://github.com/gorhill/uMatrix
[Issues]: https://github.com/uBlockOrigin/uBlock-issues/issues
[Beta]: https://github.com/gorhill/uBlock/blob/master/dist/README.md#for-beta-version
[Wiki]: https://github.com/gorhill/uBlock/wiki
<!----------------------------------[ Badges ]--------------------------------->
[Badge Localization]: https://d322cqt584bo4o.cloudfront.net/ublock/localized.svg
[Badge Commits]: https://img.shields.io/github/commit-activity/m/gorhill/ublock?label=Commits
[Badge Mozilla]: https://img.shields.io/amo/rating/ublock-origin?label=Firefox
[Badge License]: https://img.shields.io/badge/License-GPLv3-blue.svg
[Badge Chrome]: https://img.shields.io/chrome-web-store/rating/cjpalhdlnbpafiamejdnhcphjbkeiagm?label=Chrome
[Badge Issues]: https://img.shields.io/github/issues/uBlockOrigin/uBlock-issues
[Badge NPM]: https://img.shields.io/npm/v/@gorhill/ubo-core