knadh/dns.toys

dns.toys is a DNS server that takes creative liberties with the DNS protocol to offer handy utilities and services that are easily accessible via the command line.

For docs, visit www.dns.toys

Sample commands

dig help @dns.toys

dig mumbai.time @dns.toys

dig 2023-05-28T14:00-bengaluru-berlin/de.time @dns.toys

dig newyork.weather @dns.toys

dig 42km-mi.unit @dns.toys

dig 100USD-INR.fx @dns.toys

dig ip @dns.toys

dig 987654321.words @dns.toys

dig pi @dns.toys

dig 100dec-hex.base @dns.toys

dig fun.dict @dns.toys

dig excuse @dns.toys

dig A12.9352,77.6245/12.9698,77.7500.aerial @dns.toys

dig 5.16.nanoid @dns.toys 

Running locally

Docker

docker run name dnstoys --restart unless-stopped -p 5354:5354/tcp -p 5354:5354/udp

Or using docker compose:

docker compose up

From source

• Clone the repo
• Copy config.sample.toml to config.toml and edit the config
• Make sure you have a copy of the cities15000.txt file at the root of this directory (instructions are in the config.sample.toml file)
• Make sure to download the wordnet from Wordnet website.(more instructions are in the config.sample.toml file)
• Extract the tarball and rename extracted the directory to wordnet
• Make sure to fetch the IFSC data (instructions are in the config.sample.toml file).
• Run make build to build the binary and then run ./dnstoys.bin
• Query against the locally running server

    dig <query> +short @127.0.0.1 -p 5354

Others

• DnsToys.NET - A .net client library for the service.