Giter VIP home page Giter VIP logo

filterlists's Introduction

GitHub last commit GitHub commit activity GitHub Maintained GitHub Maintained Hits


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

ubo_lists_Oct_2023


Content

  1. Custom Filters
    1. Privacy
    2. Annoyances
    3. Security
    4. All-Purpose
  2. Setup Examples
    1. Enhanced
    2. Pro
    3. Optimized
  3. Block Content with Fewer Rules
    1. Selectively Disable Cosmetic Filters
    2. Optimized Lists
  4. Advanced Settings
  5. FAQ
  6. Additional Reading
  7. Mentions

Custom Filters

How to import custom filters into uBlock Origin (uBO):

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

Privacy

  1. Hagezi's Personal DNS Blocklist (48k domains) | subscribe
    Hagezi's manually maintained blocklist includes ad and tracker domains seen on the top website lists (Umbrella/Tranco/Statvoo) and extracted domains from his DNS wildcard rules. This is the core of Hagezi’s five primary DNS blocklists, which are much larger and more appropriate for DNS-level blocking.

  2. 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 Annoyance lists. ⚠️ This list may break third-party logins!

  3. yokoffing's click2load filters (47 rules) | subscribe
    (optional: included in Privacy Essentials below) 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.

  4. Privacy Extended (17k rules) | subscribe
    As a fork of AdGuard Tracking Protection, this list eliminates extra allowlisting caused by different methods between uBO and AdGuard, and resolves issues faster if the problems are inconsistent between the two. Privacy Extended also removes redundant filters found in EasyPrivacy.

URL Tracking Parameters

Add the functionality of ClearURLs to uBO. If you find websites with tracking parameters or experience breakage, you can submit those here.

  1. Actually Legitimate URL Shortener Tool (2k rules) | subscribe
    This list also includes all entries from AdGuard's URL Tracking Protection as of October 2022.

  2. ClearURLs for uBO (700 rules) | subscribe
    (optional: This list may break websites and may contain problematic rules. There is not much the maintainers can do, as this list is just the ClearURLs rules converted into a filterlist.)

Fonts

  1. Block third-party fonts (70 rules) | subscribe
    (optional: This will break the "look and feel" of some sites.) A successor to Fanboy's Anti-thirdparty Fonts, this option blocks all web fonts from third-party providers but allows the browser to download fonts from first-party domains. I prefer this method because it avoids third-party domains (speed and privacy benefit), and I trust the first-party site to download a font from them.1

Annoyances

  1. 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. Browse websites without logging in (370 rules) | subscribe
    This list attempts to bypass forced logins on sites.

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

Paywalls

⚠️ To bypass paywalls effectively, you should use the Bypass Paywalls Clean extenstion for Chrome or Firefox. These lists are limited in what they can do and are therefore optional:

  1. Bypass Paywalls Clean filter (960 rules) | subscribe
    The Bypass Paywalls Clean (BPC) filter is from the same developer as the add-on implementation. 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. Most Abused TLDs (213 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.

  2. Dandelion Sprout's Anti-Malware List (88k rules) | subscribe
    This list blocks domains with high abuse rates and their search results. It also blocks domains involved in malware redirects, domain parking, and Windows PUP ads. It has many other subcategories that distinguish it from similar lists.

  3. The malicious website blocklist (38k rules) | subscribe
    This version includes author comments, vxvault.net's list, the anti-PUP list, and additional rules for uBO.

All-Purpose

  1. uBlock combo list (81k rules) | subscribe
    (optional: You may not want all these sub-filters, or you may prefer to use the separate lists) This list filters URL tracking parameters as well as malware, scams, and phishing. It combines the following lists: Dandelion Sprout's Anti-Malware List, Actually Legitimate URL Shortener Tool, The malicious website blocklist, and the anti-typo list.

Setup Examples

I've provided three setup guides: Enhanced, Pro, and Optimized.

Enhanced

Features

  • Demonstrates the power of uBO
  • Blocks most cookie pop-ups, site notifications, and anti-adblock notices
  • Adds additional privacy protections against URL tracking and third-party domains
  • Adds security protections from known badware domains (optional)
  • You have a low threshold for site breakage

Built-in lists

In addition to the default lists, you should also enable:

  1. EasyList - Cookie Notices
  2. EasyList - Notifications (if you don't already have these disabled in your browser)
  3. EasyList - Social Widgets (if they bother you)
  4. uBlock filters - Annoyances (anti-adblock messages)

Custom lists

  1. Hagezi's Personal DNS Blocklist
  2. yokoffing's click2load filters
  3. Actually Legitimate URL Shortener Tool
  4. The Security lists (if you browse high-risk categories like torrents, piracy, and third-party streaming sites, or want more peace of mind, etc.)

Pro

Features

  • Get the most value from customizing uBO
  • Blocks more annoyances
  • Adds significant privacy protection
  • Adds security protection against abused TLDs
  • You should be comfortable troubleshooting issues and reporting site breakage, though it should be rare

Built-in lists

In addition to the default lists, you should also enable:

  1. Block Outsider Instrusion into LAN
  2. AdGuard – Popup Overlays (newsletter pop-ups)
  3. EasyList - Annoyances (all lists)
  4. uBlock filters - Annoyances

Custom lists

  1. Privacy Essentials
  2. Hagezi's Personal DNS Blocklist
  3. Privacy Extended
  4. Actually Legitimate URL Shortener Tool
  5. yokoffing's Annoyance List (+ any of the other Annoyance lists)
  6. Most Abused TLDs

Optimized

  • Ideal for mobile or older devices, or users who really enjoy efficiency
  • Thorough blocking with reduced rule count

Replace one-for-one with Optimized Lists.


Block Content with Fewer Rules

Selectively Disable Cosmetic Filters

One way to improve performance without compromising security or privacy is to disable cosmetic filtering. Cosmetic filtering (aka element hiding) stops ads and other nuisances on the page; it only affects how the website looks. Toggling it off when you don't need it will reduce the workload on your device while still blocking unwanted network requests.

For sites where uBO seems unnecessary (e.g., pages with no ads), turn off cosmetic filtering for the site. This will still protect you from security and privacy risks (network requests) but reduce overhead to page load.

Optimized Lists

uBO can handle 300k+ filters, but you might not need that many rules to block unwanted content effectively. You can use some alternative lists that have fewer rules than the built-in ones if you want to save CPU and memory on your device.

AdGuard provides filters that are optimized by removing rules that are rarely used. These lists are designed to be lighter and faster but still maintain high standards for content blocking. The optimization process relies on the statistics of how often AdGuard users apply different rules, which they opt-in to share.

⚠️ By the very nature of these filterlists, they may not block 100% of what their original format blocks. This is obvious, but it's worth remembering for when you're trying to debug lack of coverage.

The rule counts shown below are when compared to their original list in uBO.

Ads

  1. Easylist (Optimized) (24k vs. 67k rules) | subscribe
    EasyList is the primary filter list that removes most adverts from web pages, including unwanted frames, images, and objects. It is the most popular list used by many ad blockers.

  2. EasyList + AdGuard Base filter (Optimized) (64k vs. 137k rules combined) | subscribe
    If Easylist (Optimized) is missing too many ads, then use this list, or stick with the built-in Easylist filter.

Annoyances

  1. Fanboy Annoyances (Optimized) (35k vs. 91k rules) | subscribe
    Hides website notifications, social media widgets, cookie notices, chat widgets, and some newsletters, thereby substantially decreasing web page loading times and uncluttering them. (Includes EasyList - Cookie Notices and EasyList - Social Widgets)

  2. AdGuard Annoyances (Optimized) (40k vs. 68k rules) | subscribe
    Blocks irritating elements on webpages including cookie notices, third-party widgets, and in-page popups. AdGuard claims that this list doesn't duplicate Fanboy Annoyances, so you can use them both together. (Unlike Fanboy's version, this list doesn’t include social media widgets and buttons. To block them, you can use AdGuard Social Media filter separately.)

  3. AdGuard Social Media filter (Optimized) (14k vs. 20k rules) | subscribe
    (optional: Redundant with Fanboy Annoyances / EasyList - Social Widgets, in my opinion) If you do not like numerous Like and Tweet buttons on all the popular websites on the Internet, then subscribe to this filter and you will not see them anymore.


Advanced Settings

Toggle on advanced settings.

advanced user

⚠️ Do not change these values blindly. Read the description for each preference.

Setting Value Description
autoUpdateAssetFetchPeriod 10 auto-updater waits x seconds before fetching the next filterlist
autoUpdateDelayAfterLaunch 5 update out-of-date filter lists x seconds after browser startup
autoUpdatePeriod 1 uBO checks for filter lists updates every x hours
cnameMaxTTL 720 cache CNAME aliases for x minutes
filterAuthorMode true enable Dynamic Filtering
updateAssetBypassBrowserCache true bypass cache when manually fetching a filter list more often than every hour

FAQ

Which browser works best with uBO?

uBlock Origin works best in Mozilla Firefox. The features supported only on Firefox include preventing unwanted DNS requests and CNAME uncloaking.

Should I use a content blocker if I have Pihole, NextDNS, ControlD, etc.?

uBlock Origin can do more compared to when only blocking requests at the DNS-level, like using cosmetic filters to hide first-party ads (e.g., YouTube ads), ad-placeholders, web annoyances, etc.1

Why should I use these lists?

See here.

Why did you include AdGuard's Optimize lists but not AdBlock Plus' Minified lists?

The Minified lists are part of an Adblock Plus-hosted unofficial project that was hardforked from their source lists in August 2019. They are smaller than AdGuard's Optimized lists but lack quality blocking. Because EL and EP are your primary defenses with content blocking, I wouldn't use the Minified lists.


Reading

uBO-specific

Filter Creation

Security


Mentions

User comments: 1 2 3 4 5 6

Guides

Contributions

Free Website Counter
23 July 2022

filterlists's People

Contributors

iam-py-test avatar itsprofessional avatar sam-oak avatar tempissue avatar yokoffing avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.