twod

NOTE: At the time of writing it's not possible to even register for a new TwoDNS account anymore. Since I haven't been using it for quite a while, and there are better alternatives around, twod won't be updated anymore.

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

configuration

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

installation

Gentoo GNU/Linux

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.

usage

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

documentation

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

tests

Tests can be run by simply installing and invoking tox:

$ tox