Blocklist Merger

A tool that merges public DNS blocklists into a single, deduplicated file optimized for AdGuard Home.

Note

Made for personal use, but feel free to use it if you find it useful.

---

✨ Features

• Fetches 80+ public DNS blocklists automatically
• Cleans rules (removes comments, cosmetic rules, browser-only modifiers)
• Deduplicates intelligently: subdomains covered by parent rules are removed
• Outputs only AdGuard Home compatible rules
• Updates every 12 hours via GitHub Actions

---

📥 Usage

1. Open AdGuard Home
2. Go to Filters → DNS blocklists
3. Click Add blocklist
4. Paste this URL:

https://github.com/MissionWAR/BlocklistMerger/releases/download/latest/merged.txt

---

📋 Sources

Upstream blocklist URLs are listed in config/sources.txt.

Each list is maintained by its original author. This project only merges and deduplicates them.

---

🔧 Building Locally

pip install .
python -m scripts.downloader --sources config/sources.txt --outdir lists/_raw --cache .cache
python -m scripts.pipeline lists/_raw lists/merged.txt

---

⭐ Acknowledgments

• AdGuard Team for AdGuard Home, their documentation, and HostlistCompiler
• Blocklist maintainers for keeping their lists updated
• Open-source community for the tools that made this possible

Caution

Please respect the licenses of the original blocklists if you fork this project.

---

📄 License

MIT