What problem does it solve?
It helps you decide whether a new Pi-hole blocklist source is high quality, fits your curation taxonomy, and won’t introduce avoidable false positives.
Core Features & Use Cases
- Structured Source Evaluation: Produces a consistent, repo-ready assessment including category, risks, format, overlap risk, and recommendation.
- Category Taxonomy Alignment: Assigns exactly one primary category from the curated list to keep additions consistent and discoverable.
- Pi-hole Readiness Checks: Verifies compatibility expectations such as raw URL availability and hosts vs plain domain list formatting.
- Curation-Oriented Output: Generates content suitable for documenting the decision and committing updates to the curated blocklist index.
Quick Start
Use pihole-blocklist to evaluate a candidate blocklist by pasting the raw blocklist URL and asking whether it should be added, skipped, or handled with caution.