Skip to content

rokartur/complete-filters

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

323 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Complete Filters

Aggressive category-based filter lists for ad blockers.

TL;DR

  • combines multiple public filter lists into category-specific outputs,
  • blocks ads, trackers, cookie banners, popups, anti-adblock, malware/phishing domains, and other unwanted web elements,
  • to add filters, go to the Available categories section,
  • the lists are intentionally aggressive, so some sites may partially break,
  • if that happens, please report it here.

What this project does

Complete Filters is an aggregator of public upstream filter sources. The project:

  • merges multiple community-maintained filter lists,
  • groups them into practical categories,
  • removes duplicate rules within each generated category,
  • adds local compatibility and manual rules where needed.

The repository is meant to provide ready-to-use category lists so you can subscribe only to the parts that fit your setup.

Important: these are aggressive filters

Complete Filters prioritizes blocking effectiveness over maximum compatibility. In practice, that means some websites, embedded widgets, sign-in flows, consent dialogs, or app-like interfaces may stop working correctly.

If something breaks:

  • check whether the problem disappears after disabling the relevant list,
  • verify that it has not already been reported,
  • open a report in Issues.

Available categories

Each file in filter/ is a separate generated list.

Category Purpose Subscribe
ads General advertising and ad delivery domains Add
annoyances Popups, overlays, newsletter nags, fake urgency, and other annoyances Add
anti-adblock Anti-adblock scripts and related countermeasures Add
brave Rules and compatibility adjustments tailored for Brave Browser filtering Add
compatibility Compatibility fixes and exceptions to reduce breakage Add
cookies Cookie banners and consent frameworks Add
hagezi Dedicated HaGeZi upstream blocklists, separated into their own subscription Add
malware Malware, phishing, scam, and otherwise high-risk domains Add
mixed Rules that do not fit neatly into a single narrow category Add
mobile Mobile-specific nuisances and mobile web clutter Add
polish Polish-language and Poland-specific ad, annoyance, and tracking rules Add
privacy Tracking, analytics, fingerprinting, and privacy-invasive requests Add
regional Poland-focused or region-specific rules Add
social Social widgets, embedded platforms, and social tracking Add
video Video ads and video-platform nuisances Add

Supported blockers

The generated lists should work with most tools compatible with Adblock-style syntax, especially:

  • uBlock Origin,
  • AdGuard,
  • AdBlock,
  • Adblock Plus,
  • Brave Browser (built-in filtering),
  • and other blockers that support Adblock-compatible filter lists.

Use with extra care

Be especially careful when using these filters in system-wide or DNS-level environments, for example:

  • AdGuard DNS,
  • AdGuard Desktop,
  • other tools that filter all traffic for the whole device or system.

Sources and attribution

This project is an aggregator. It uses publicly available filter lists maintained by the adblock community and respects the rights and licenses of their original authors.

The canonical upstream URL manifests live in categories/. Each filter/<category>.txt output is generated from the matching categories/<category>.txt manifest and then merged with local compatibility/block overrides from manual-rules/.

Local repo-maintained overlays currently added during builds include:

Category source overview:

The full raw upstream URL list is intentionally kept in the category manifests rather than duplicated in the README. Before redistributing generated outputs, review the licenses and attribution requirements of the relevant upstream projects.

What to report

Issues are especially useful for:

  • sites or page elements that stop working after enabling a list,
  • false positives,
  • ads or trackers that are still not blocked,
  • missing compatibility exceptions,
  • new sources or rules worth adding.

License

This repository acts as an aggregator of filter lists.

  • the repository code and documentation are covered by the license described in LICENSE,
  • upstream lists and other imported rule content remain under the licenses chosen by their original authors,
  • before redistributing generated outputs, review the licensing terms of the relevant upstream sources.

About

Aggressive category-based filter lists for ad blockers

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages