Skip to content

Latest commit

 

History

History
31 lines (22 loc) · 1.17 KB

README.md

File metadata and controls

31 lines (22 loc) · 1.17 KB
Raw

nxdomain

Build status

A domain (ad) block list creator. Takes block lists from local files or URLs as input (in hosts(5) or domain-list format) and outputs a BIND zone or dnsmasq config.

Version notes: see CHANGELOG.

Sample usage

$ python -m nxdomain \
    # Where to store the output file.
    --out=adblock.zone \
    # BIND Response Policy Zone file. Also available: --format=dnsmasq.
    --format=bind \
    # A simple list of domains, one per line. Lines starting with '#' are skipped.
    --simple=https://v.firebog.net/hosts/static/w3kbl.txt \
    # A hosts(5) formatted list of domains. Lines starting with '#' are skipped.
    --hosts=https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts

Notes

This program does not try to be smart. Reloading the DNS server is your responsibility. There is no caching or smart diffing. The only smartness is that, with --format=bind, the SOA serial will be incremented automatically if the file already exists.

License

GNU General Public License v3.0 only.