Specification
The blocklist is a text file containing domain rules formatted for compatibility with standard ad-blocking engines.- Syntax: Adblocking Plus (ABP)
- Format:
||domain.com^(wildcard blocking) - Update Frequency: Continuous (Community-maintained)
- Source: GitHub Repository
CDN Endpoint
For integration, use the jsDelivr CDN endpoint for high availability and low latency:Compatibility
The list is designed for engines that support Adblock Plus (ABP) syntax for DNS or network-level blocking.Supported Software
- Pi-hole
- AdGuard Home
- uBlock Origin
- Brave (Shields: Aggressive)
- Little Snitch Mini
- eBlocker
Incompatible
- DNSMasq / NextDNS / DNSCrypt
- Hostfile-based blockers
- pfBlockerNG / OPNsense
- Standard DNS Resolvers (Bind, Unbound)
Integration
Pi-hole
- Navigate to Group Management > Adlists.
- Add the CDN URL as a new list.
- Update Gravity (
pihole -g).
AdGuard Home
- Navigate to Filters > DNS blocklists.
- Click Add blocklist > Add a custom list.
- Enter
hapara.failas the name and the CDN URL. - Click Save.
uBlock Origin
- Open Settings > Filter lists.
- Scroll to Custom and click Import.
- Paste the CDN URL and click Apply changes.
Contributing
We accept community contributions to keep the blocklist effective.Reporting Issues
- Request a Block: Suggest a new service or domain.
- Report False Positive: Report broken legitimate sites.
Submitting Changes
- Fork & Branch: Create a new branch for your changes.
- Edit
blocklist.txt:- Use Adblock Plus Syntax:
||domain.com^ - One domain per line.
- Place under correct Vendor Header.
- Use Adblock Plus Syntax:
- Verify: Check for trailing spaces or accidental deletions.
- Pull Request: Submit PR with a clear description.