🛡️ ErebusTN Pi-hole Blocklists

Curated DNS blocklists for Pi-hole, AdGuard Home, and other DNS-based ad blockers. Automatically updated every 30 minutes with intelligent deduplication and categorization.

---

📋 Available Lists

File	Description	Domains	Size
blacklist.txt.part1	Master list — All domains combined (Part 1)	3,820,435	90.00 MB
blacklist.txt.part2	Master list — All domains combined (Part 2)	2,371,243	54.96 MB
categories/spam.txt	Email spam, referrer spam	87,734	1.45 MB
categories/suspicious.txt	Heuristically flagged domains	1,541,929	32.89 MB
categories/advertising.txt	Ads, banners, ad networks	628,696	14.67 MB
categories/tracking.txt	Analytics, telemetry, Smart TV trackers	748,606	19.46 MB
categories/malicious.txt	Malware, phishing, scams	1,671,965	38.76 MB
categories/porn.txt	Adult content	2,501,405	60.81 MB
categories/gambling.txt	Casinos, betting sites	194,997	3.59 MB

---

🚀 Quick Start

Pi-hole

1. Go to Group Management → Adlists

2. Add the raw URLs:

   https://raw.githubusercontent.com/EGen-V/PiHole-List/main/blacklist.txt.part1
   https://raw.githubusercontent.com/EGen-V/PiHole-List/main/blacklist.txt.part2
   

   Or add specific categories:

   https://raw.githubusercontent.com/EGen-V/PiHole-List/main/categories/advertising.txt
   https://raw.githubusercontent.com/EGen-V/PiHole-List/main/categories/tracking.txt
   https://raw.githubusercontent.com/EGen-V/PiHole-List/main/categories/malicious.txt
   

3. Run Tools → Update Gravity

AdGuard Home

1. Go to Filters → DNS blocklists
2. Click Add blocklist → Add a custom list
3. Add each URL separately (AdGuard Home has a per-list size limit)

Other DNS Blockers

Most DNS-based blockers support the same URL format. Check your specific software's documentation for adding custom blocklists.

---

📊 Sources

These lists aggregate and deduplicate domains from 100+ trusted sources including:

Source	Description
OISD	Comprehensive mega-list with minimal false positives
Hagezi	Pro, Ultimate, and category-specific lists
StevenBlack	Unified hosts with extensions
Firebog	Curated collection of tick lists
NextDNS	Native tracking protection
Developer Dan	Ads and tracking extended
Phishing.Database	Active phishing domains
BlocklistProject	Category-specific blocklists
1Hosts	Pro and Lite variants
NoTracking	Privacy-focused lists

Full source list available in list.txt

---

⚡ Features

Intelligent Processing

• Multi-format Support — Automatically detects and parses hosts files, domain lists, and AdBlock rules
• Smart Categorization — Domains automatically categorized by type (ads, tracking, malware, etc.)
• Deduplication — Removes duplicates across all sources
• Whitelist Support — Exclude domains and entire TLDs from blocking

Automation

• GitHub Actions — Fully automated updates every 30 minutes
• README Auto-Update — Statistics table updates automatically
• Git Integration — Smart commits with detailed change summaries

---

🔄 Update Frequency

• Automatic: Every 30 minutes via GitHub Actions
• On-Demand: Manual trigger available in GitHub Actions tab
• Change-Driven: Also updates when source list (list.txt) changes

---

🤝 Contributing

Contributions are welcome! Here's how you can help:

1. Add Sources: Submit PRs with new blocklist URLs
2. Report Issues: Found false positives? Open an issue
3. Improve Code: Performance optimizations, bug fixes, new features

Suggesting New Sources

Open an issue with:

• Source URL
• Description
• Estimated domain count
• Update frequency
• License/terms

---

📜 License

Public domain. Use freely. No attribution required (but appreciated!).

Individual blocklist sources may have their own licenses. Respect upstream source terms.

---

⚠️ Disclaimer

These blocklists are provided "as-is" without warranty. While we strive for accuracy:

• False positives may occur — Some legitimate sites might be blocked
• Test before deploying — Use in a test environment first
• Maintain whitelists — Keep a whitelist for critical services
• Not legal advice — Blocking decisions are your responsibility

---

🙏 Acknowledgments

Thanks to all the providers of the upstream blocklists that make this project possible:

• OISD by sjhgvr
• Hagezi by Hagezi
• StevenBlack by Steven Black
• Firebog by WaLLy3K
• And 100+ other contributors

---

📞 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions

---

Maintainer: ErebusTN

Last Update: January 2026

Repository: github.com/EGen-V/PiHole-List