Destronia AdBlock Filter

A curated set of AdBlock/uBlock/AdGuard filter rules maintained by the Destronia community. The repository is data-first — it stores filter lists and per-site rules organized by year.

Quick install

1. Open your adblocker's dashboard (for uBlock Origin: Dashboard → Filter lists → 3rd-party filters).
2. Add this raw list URL as a third-party filter:

Raw filters.txt on GitHub

1. Enable the list and refresh/update filters in your blocker.

If you prefer a step-by-step guide for uBlock Origin, see the uBlock Origin docs: Dashboard - Filter lists (3rd-party filters)

Files and structure

• filters/filters.txt — master list that includes year-based rule files.
• filters/filtersYYYY.txt — year-scoped rule files (e.g. filters2021.txt).
• VERSION — release version used for publishing.
• docs/ — documentation and contributor guides.

Additions and edits should usually be made to the appropriate filters202X.txt file for the year of the change.

Contributing

We welcome contributions. Small PRs are preferred (single-site or small related rule sets).

Steps to contribute a new rule:

1. Add the rule to the appropriate year file under filters/ (create filters2026.txt if adding current-year rules).
2. Include a short comment explaining the site/page targeted and why the rule is safe (see docs/rules-layout.md).
3. Update filters/filters.txt only when adding a new year file — add an !#include filters2026.txt line and bump headers (see repo guidance).
4. Open a PR with a concise title (for example: "Add block rule for example.com — fixes issue 123") and include test steps and a brief rationale.

See the full contributing guide: .github/CONTRIBUTING.md

Troubleshooting

• If ads still appear after enabling the list, force a manual update in your blocker and clear the browser cache.
• If a site breaks after applying a rule, open an issue with the URL, a short description, and which rule you suspect.

Recommended blockers

• uBlock Origin — lightweight and configurable: uBlock Origin
• AdGuard — privacy-focused blocker with GUI apps: AdGuard

Contributors ✨

Thanks goes to these wonderful people:

redtrillix 📖 💻 ⚠️

JakeWasHere2 📖

This project follows the all-contributors specification. Contributions of any kind welcome!

---

This page is a work in progress. See .github/CONTRIBUTING.md for documentation contribution instructions.