Guidelines

1. Prevent overblocking by applying the law of diminishing returns (always blocking more ≠ better blocking experience).
2. Aim for efficiency without sacrificing quality (use sane, quality resources).
3. Implement the minimum number of useful lists (avoid redundancy and bloat when possible).

Recommended filters for uBlock Origin

Block Twitch ads

For Twitch adblock, I use Violentmonkey with the AdGuard Extra userscript. This helps uBlock Origin block server-side ads.

You can also use Tampermonkey as a Twitch adblock solution.

Block YouTube ads

Adblock not working on YouTube?

• uBlock Origin on Firefox should be okay. If adblock is no longer working on YouTube, check the subreddit.
• If using uBlock Origin Lite, open the popup panel and set the filtering mode to Complete on youtube.com and any other ad-invasive site.
  • For more info, see our new section on uBlock Origin Lite.

Content

1. How to add custom filters
   1. Privacy
   2. Annoyances
   3. Security
   4. All-Purpose
2. Examples
   1. Enhanced
   2. Pro
   3. Optimized
3. Mobile adblocking: block content with fewer rules
   1. Disable cosmetic filters
   2. Optimized lists
4. Advanced settings
5. uBlock Origin Lite
6. FAQ
7. Additional reading
8. Mentions

How to add custom filters

[!NOTE] This repo is tailored to uBlock Origin specifically. I cannot guarantee filters will work in other ad blockers.

uBlock Origin

Get uBlock Origin (uBO), if you don't have it already.

To import custom filters into uBlock Origin:

1. Click the subscribe link by one of the entries below.
2. In the new tab that opens, click on Subscribe in the top right corner.
3. Close tab, then repeat for other lists you want to add to uBO.

AdGuard

To import custom filters into AdGuard:

1. Click the subscribe link by one of the entries below.
2. In the new tab that opens, click on Next.
3. Toggle the box that says Trusted, then click Subscribe.

Brave Browser

Brave uses the default uBlock Origin lists out-of-the-box.

Do not use the subscribe link. Add your own custom filter lists from different sources just copying/pasting the RAW URL and pressing save changes.

1. Click on the title of the list from the selections in this repo.
2. On GitHub, select Raw on the right-hand side of the page.
3. Copy the URL.
4. In a separate tab, go to brave://adblock in the URL bar.
5. Under Add custom filter lists, paste the URL and select Add.

AdBlock Plus

There is a branch specifically for Adblock Plus (ABP) syntax. Check it out here.

To import custom filters into ABP:

1. Click the subscribe link by one of the entries below.
2. In the new tab that opens, select Yes, Add This Filter List.

AdBlock

To import custom filters into AdBlock:

1. Click the subscribe link by one of the entries below.
2. In the dialog box that pops up, press OK.

Other ad blockers

Do not use the subscribe link. Instead, do the following:

1. Click on the title of the list from the selections below.
2. In GitHub, click Raw on the right-hand side of the page.
3. Copy+paste the URL to your preferred ad blocker.
4. Follow your ad blocker's instructions for adding custom lists.

Privacy

1. :star: Privacy Essentials (1k rules) | subscribe
   A curated list for advanced hardening. Includes click2load filters^{^what is this?} and blocks requests like connect.facebook.com and more that are not covered by uBO's default settings or in Annoyances lists.

[!WARNING] Privacy Essentials may prevent you from logging into sites using Facebook, Google, or other third-party accounts.

1. yokoffing's click2load filters (47 rules) | subscribe
   (optional if using Privacy Essentials) Turns many third-party audio and video players into click-to-load placeholders which only load once a user clicks on it. This list speeds up page load, uses less bandwidth and browser resources, and reduces privacy exposure (by contacting fewer domains during page load). The player will load by clicking on the placeholder.

2. :star: Hagezi Pro mini (56k domains) | subscribe
   A smaller version of the Hagezi Pro DNS blocklist optimized for web browsers (56k vs. 208k rules). The streamlined list excludes rules not pertinent to web browsing, like those blocking IoT tracking and device telemetry. This mini version blocks domains associated with ads, tracking, analytics, and badware.

URL Tracking Parameters

Add the functionality of ClearURLs to uBO. These filter lists automatically remove tracking elements from URLs to protect your privacy when browsing the Internet.

1. :star: Actually Legitimate URL Shortener Tool (2.8k rules) | subscribe
   This list also includes all entries from AdGuard's URL Tracking Protection as of October 2022, but you can use both lists.

2. ClearURLs for uBO (700 rules) | subscribe
   This list is just the rules from the ClearURLs extension converted into a filterlist.

[!TIP] If you find websites with tracking parameters or experience site issues, you can submit those here.

Fonts

1. Block third-party fonts (89 rules) | subscribe
   This filter blocks fonts from third-party domains, which improves page load speed and protects your privacy. There are built-in exceptions to minimize site issues, such as allowing for font icons. Overall, it's more flexible than blocking all third-party fonts outright (e.g., $font,3p).

[!NOTE] Blocking web fonts will affect the "look and feel" of some sites.

Annoyances

1. :star: yokoffing's Annoyance List (1k rules) | subscribe
   A curated list that captures nuisances missed by other maintainers. It also cleans up the clutter around many sites (e.g., related articles, "read more", etc.).

2. Fanboy's Agegate List | subscribe
   For age-gated content.

3. Browse websites without logging in (370 rules) | subscribe
   This list attempts to bypass forced logins on sites.

4. YouTube Clear View (17 rules) | subscribe
   Cleans up some of the clutter on YouTube.

Paywalls

To most effectively bypass paywalls, use the Bypass Paywalls Clean extension. The blocklists are limited in what they can do and are therefore optional.

1. Bypass Paywalls Clean filter (960 rules) | subscribe
   You do not need this filterlist if you use the extension.

2. Anti-paywall filters (2k rules) | subscribe
   This list blocks additional third-party requests and annoyances that are not covered in the Bypass Paywalls Clean filterlist.

Security

High-risk sites can expose your device to threats. These lists can prevent that by warning you before navigation or limiting what you can access.

1. :new: High-Entropy NRDs (7-day) (509k rules) | subscribe
   Targets newly registered domains (NRDs) from the past 7 days that exhibit structural randomness. "High entropy" describes domains that look like computer-generated gibberish, such as qj9z2x5m0l.com. Attackers use Domain Generation Algorithms (DGAs) to produce addresses daily so that infected devices can secretly "phone home" to command servers. Note that this blocklist will not catch sophisticated phishing attacks that use readable dictionary words to mimic legitimate brands, such as verizon-wireless-login.com. Domains are provided by Stamus Labs.

2. Most Abused TLDs (286 rules) | subscribe
   Displays a warning before navigating to a site with an abused TLD. Allows exceptions for legitimate sites. Merged from my own Enhanced website protection list, Dandelion Sprout's Anti-Malware List, LennyFox's Block non-Latin TLDs list, and Spamhaus statistics.

3. **[Dandelion Sprout's Anti-Malware List](https://gith