dnslist

dnslist is a Python package that allows to easily load domain list from various sources and merge them together. It is mainly used for merging ads/malware domain list together.

1   Installation

1.1   Requirements

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

1.2   From github

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

$ python3 setup.py install --user

1.3   From pip

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

$ python3 -m pip install --user dnslist

2   Usage

dnslist comes with both a Python module and an executable tool. You will more lilely want to use the executable directly.

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

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.

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

2.4   Examples

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