https://github.com/knadh/dns.toys

A DNS server that offers useful utilities and services over the DNS protocol. Weather, world time, unit conversion etc.
https://github.com/knadh/dns.toys

dns dns-server fun unit-conversion weather

Last synced: 25 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/knadh/dns.toys
• Owner: knadh
• License: mit
• Created: 2022-06-01T17:21:33.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2024-07-02T05:45:23.000Z (4 months ago)
• Last Synced: 2024-09-27T02:47:19.395Z (about 1 month ago)
• Topics: dns, dns-server, fun, unit-conversion, weather
• Language: Go
• Homepage: https://www.dns.toys
• Size: 163 KB
• Stars: 2,485
• Watchers: 22
• Forks: 135
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• my-awesome - knadh/dns.toys - server,fun,unit-conversion,weather pushed_at:2024-07 star:2.5k fork:0.1k A DNS server that offers useful utilities and services over the DNS protocol. Weather, world time, unit conversion etc. (Go)
• awesome - knadh/dns.toys - A DNS server that offers useful utilities and services over the DNS protocol. Weather, world time, unit conversion etc. (Go)

README

        


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 A12.9352,77.6245/12.9698,77.7500.aerial @dns.toys

```

## Running locally

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

- Run `make build` to build the binary and then run `./dnstoys.bin`

- Query against the locally running server

```shell

    dig  +short @127.0.0.1 -p 5354

```

## Others

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