pihole-blocklist

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.