The Block List Project curates and maintains blocklists of domains known for unwanted content. We provide these lists to give users control over what is blocked, offering a more granular approach than blanket blocking. Our lists are free, regularly updated, available in multiple formats, and community-maintained. We rebuilt our infrastructure from the ground up to improve maintainability, reliability, and contributor experience.
The project offers a significantly improved infrastructure with a modernized codebase and automated testing suite. It features a config-driven architecture for managing list definitions and robust validation processes to ensure accuracy and prevent accidental blocking of legitimate domains. The system underwent a complete rewrite, resulting in a more scalable and maintainable solution for both users and contributors.
- List Formats: Supports multiple formats including Pi-hole, AdGuard, dnsmasq, and hosts file formats for broad compatibility.
- Regular Updates: Lists are automatically updated on every change, ensuring users have access to the latest blocklists.
- Community Maintained: Relies on community submissions and issue tracking for list additions and removals.
- Automated Validation: Incorporates automated validation to minimize errors and ensure list integrity.
- Config-Driven Architecture: List definitions are managed through a configuration file, enabling easy customization and updates.
- Comprehensive Categories: Offers lists across various categories like abuse, ads, crypto, drugs, and gambling.
- Scalable Infrastructure: New architecture moves from JavaScript scripts to a Python codebase with automated testing.
The project has recently undergone a significant overhaul with a complete rewrite of its infrastructure. The new system includes 151 automated tests and a robust CI/CD pipeline, significantly improving reliability. The community is actively involved in contributing and maintaining the lists. The project's active development and the implementation of automated validation measures contribute to its increasing dependability.
The Block List Project benefits individuals and organizations seeking to filter unwanted content, such as ads, malware, and malicious domains. It provides a valuable tool for enhancing online safety and privacy by enabling granular control over website access. By offering open-source, regularly updated, and format-flexible blocklists, the project provides users with a high-value alternative to manual blocking methods and contributes to safer online browsing.