# knadh/dns.toys

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

Repository: https://github.com/knadh/dns.toys
Canonical: https://ross.abutalabs.com/products/dnstoys
Homepage: https://www.dns.toys
Language: Go
License: MIT
License Family: permissive
Topics: dns, dns-server, fun, unit-conversion, weather
Last push: 2026-02-26T16:12:54+00:00

## Health v2 (maintenance only)
Score: 65/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 69, release rhythm 40, longevity 100
- inputs: {"age_days": 1554, "days_push": 188, "days_rel": 488, "gap_med": 0, "n_releases_24m": 6}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2821, forks 187 (observed 2026-08-28T04:07:24.016273+00:00)

## What it is
dns.toys is a DNS server written in Go that repurposes the DNS protocol to serve handy utilities like weather, world time, unit and currency conversion, and more, queryable via dig from the command line. It can be used as a public service or self-hosted via Docker or from source.

## Use cases
- get weather for a city from the terminal
- check current time or convert time between cities
- convert units like km to miles via dig
- convert currencies with daily exchange rates
- generate uuids, nanoids, or random numbers
- look up word definitions over dns
- self-host a fun dns server with utilities

## When to choose
- you want quick command-line access to utilities without opening a browser
- you want to self-host a playful dns-based utility server
- you want to demo creative uses of the dns protocol

## When to avoid
- you need reliable, production-grade dns resolution or authoritative dns hosting
- you need structured api responses rather than dns txt records
- you need guaranteed accuracy for weather or currency data

## Facets
- artifact type: service
- maturity: active
- function: networking, developer-tools, cli
- domain: developer-tools, networking
- platform: go, self-hosted, cross-platform
- tags: dns-server, utilities, weather, unit-conversion, currency-conversion, timezone, fun, command-line, docker

## Member repositories
- knadh/dns.toys (main) score 65

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:24.016273+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:38:18.875238+00:00, confidence not recorded.
  - readme: https://github.com/knadh/dns.toys (fetched 2026-08-28T04:07:24.016273+00:00, sha 83e87a23d899)
  - homepage: https://www.dns.toys (fetched 2026-08-29T09:53:38.240669+00:00, sha c95049e9cd48)
- Data as of 2026-08-30T08:39:29.467469+00:00.