I used to build a range of Adblock lists, including a modified version of the Easylist ad blocking list.

However it wasn't really feasible to continue publishing and maintaining those lists (more information in jira-projects/ADBLK#1) so this set of lists was born.

To use the blocklists, you should use one of the following URLS

• https://raw.githubusercontent.com/bentasker/adblock_lists_v2/master/lists/adblock_plus.txt
• https://raw.githubusercontent.com/bentasker/adblock_lists_v2/master/lists/unbound.txt
• https://raw.githubusercontent.com/bentasker/adblock_lists_v2/master/lists/blockeddomains.txt
• https://raw.githubusercontent.com/bentasker/adblock_lists_v2/master/lists/regexes.txt
• https://raw.githubusercontent.com/bentasker/adblock_lists_v2/master/lists/zones.txt

Which URL will obviously depend on which system you're having consume

If you're using pihole then you'll want to use blockeddomains.txt and might also want to configure Pi-Hole to update blocklists more regularly

The list directory in this repository contains more or less a single adblock list published in a number of different formats formats

• adblock_plus.txt: Adblock Plus and UBlock Origin compatible format
• unbound.txt: Unbound config compatible format
• blockeddomains.txt: A simple list of Blocked domains
• regexes.txt: A list of zone wide blocks
• zones.txt: A list of zone wide blocks

The list of blocked zones can be used with a parser to generate regexes to feed into PiHole.

The list directory also contains allowlists which can be used (in Pi-Hole etc) to override some of the more extreme blocks implemented by some third party lists.

• alloweddomains.txt

These can be periodically imported into Pi-Hole by using pihole_update_whitelist.py.

The blocklists are built based upon files within the config directory

• manualpages.txt: full URLs, will be included in the ABP lists. If a domain is specified with no path/args then it'll generate a zone-wide block too
• manualzones.txt: DNS zones to block. Anything listed here will have every subdomain of it blocked (where possible)
• manualblocks/* : directory of domain names to block - seperate files can be used to maintain a semi-logical order
• regexes/*: a directory of regexes to block - seperate files can be used to maintain a semi-logical order

The lists are updated via git hooks, so when first cloning the repo down it's necessary to run

hooks/post-merge

The hooks should be self-maintaining after that.

Lists and scripts are licensed under the BSD 3 Clause License and are Copyright (C) 2022 Ben Tasker