1.1.1 Requirements

dnslist requires Python 3. It has been tested on Python 3.6 on Linux. For dependencies, see requirements.txt file.

1.1.2 From github

You can clone this repository and install it with setuptools directly:

$ python3 setup.py install --user

1.1.3 From pip

As every pip available package, you can install it easily with the pip package:

$ python3 -m pip install --user dnslist

1.2.1 Configuration

First, you will need to create a configuration file with toml syntax:

[source.yoyo]
url = "https://pgl.yoyo.org/adservers/serverlist.php?hostformat=nohtml&showintro=0"

This file should most likely resides in ~/.config/dnslst/config.toml

1.2.2 Generation

Then you can just execute the dnslist executable tool:

$ dnslist domains.txt

This should generate a domain.txt file in the current working directory.

1.2.3 Template

You can customize how the generated file looks like by providing a moustache template:

$ dnslist -t <path/to/template.moustache> domains.txt

If you need help with moustache syntax, you can check out the:

• Officiel moustache website: https://mustache.github.io/

• Underlying rendering module: https://github.com/noahmorrison/chevron

1.2.4 Examples

Take a look at the examples/ directory for some classic configurations or templates.