twod is a daemon that updates your TwoDNS host IP entries.

twod will look for a configuration file in /etc/twod/twodrc. Optionally you can tell twod to use a specified configuration file instead by using the -c parameter.

Example config:

[general]
user      = username@example.com
token     = token
host_url  = https://api.twodns.de/hosts/myexamplehost
interval  = 3600
timeout   = 16
redirects = 2

[ip_service]
mode      = random
ip_urls   = https://icanhazip.com https://ipinfo.io/ip

[logging]
level     = WARNING

1. Install twod from my little overlay.
2. Copy /usr/share/doc/twod-<version>/examples/twodrc.example to /etc/twodrc and change the settings according to your setup.

After installing twod you can control it like any other service:

$ /etc/init.d/twod start

To run the daemon manually you can just call the twod binary:

$ twod

You can find detailed documentation at twod's Read the Docs page, powered by Sphinx.

Tests can be run by simply installing and invoking tox:

$ tox