discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens

knadh/dns.toys · source

Snapshot 0 · 2026-11-04T12:47:27Z · Go · MIT

GitHub description at capture

A DNS server that offers useful utilities and services over the DNS protocol. Weather, world time, unit conversion etc.

README at capture

<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**](https://www.dns.toys)

## Sample commands

```shell
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

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

Or using docker compose: 

```sh
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](https://wordnetcode.princeton.edu/3.0/WNdb-3.0.tar.gz).(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
```shell
    dig <query> +short @127.0.0.1 -p 5354
```

## Others

- [DnsToys.NET](https://github.com/fatihdgn/DnsToys.NET) - A .net client library for the service.