knadh/dns.toys

<img width="150" src="https://user-images.githubusercontent.com/547147/171995179-b9d2faae-d659-4260-99df-04c62c171f6f.png" />

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.