block/README.md

# block

A collection of domains, wildcards and substrings designed for [`dnscrypt-proxy`](https://github.com/DNSCrypt/dnscrypt-proxy) filter method.

- __domains-blocklist.conf:__ is used to configure the sources to merge during the process.
- __domains-blocklist-local-additions.txt:__ is used during the generation process to add your own additions and remove duplicates from the sources.
- __domains-allowlist.txt:__ is used during the generation process to remove legit domains.
- __example-blocklist.txt:__ contains valid name patterns for this purpose.
- __generate-domains-blocklist.py:__ is the script used to launch the generation process.

### Sources

Updated sources from the following locations are always merged and included.

| Source | Maintainer(s) | Description | Home Page | RAW Source | License |
|--------|:-------------:|-------------|:---------:|:----------:|:-------:|
Energized Ultimate | Energized Team | A merged domains file from a variety of other lists  | [LINK](https://energized.pro/) | [RAW](https://block.energized.pro/ultimate/formats/domains.txt) | MIT |
Energized Regional | Energized Team | A merged domains file from a variety of other lists  | [LINK](https://energized.pro/) | [RAW](https://block.energized.pro/extensions/regional/formats/domains.txt) | MIT |
Energized Xtreme | Energized Team | Blocklist of ads and tracker domains  | [LINK](https://energized.pro/) | [RAW](https://block.energized.pro/extensions/xtreme/formats/domains.txt) | MIT |
Frogeye 1st-party Trackers | Geoffrey Frogeye | Blocklist of 1st-party trackers | [LINK](https://hostfiles.frogeye.fr/) | [RAW](https://hostfiles.frogeye.fr/firstparty-trackers.txt) | All Rights Reserved |
NextDNS 1st-party Trackers | NextDNS | Blocklist of 1st-party trackers | [LINK](https://nextdns.io/) | [RAW](https://raw.githubusercontent.com/nextdns/cname-cloaking-blocklist/master/domains) | MIT |
The Quantum Ad-List | The Quantum Alpha and Pinkisjustnumbers | Blocklist of ads and tracker domains (made by an AI) | [LINK](https://gitlab.com/The_Quantum_Alpha/the-quantum-ad-list) | [RAW](https://gitlab.com/The_Quantum_Alpha/the-quantum-ad-list/-/raw/master/For%20hosts%20file/The_Quantum_Ad-List.txt) | The Unlicense |

### Build

To generate your own list you can clone this repo, edit files according to your needs and run this command:
```
python generate-domains-blocklist.py > list.txt.tmp && mv -f list.txt.tmp list
```

### Notice

<table>
<tr>
<td>
When it has reached a stable level the blocklist will be shared here as release.
</td>
</tr>
</table>