posting to DNS
Go to file
sneakers-the-rat 0b8b640954 Initial 2023-06-07 02:24:33 -07:00
dnsocial Initial 2023-06-07 02:24:33 -07:00
.gitignore Initial 2023-06-07 02:24:33 -07:00
LICENSE Initial commit 2023-06-07 06:41:38 +00:00 Initial 2023-06-07 02:24:33 -07:00
poetry.lock Initial 2023-06-07 02:24:33 -07:00
pyproject.toml Initial 2023-06-07 02:24:33 -07:00


DNSocial is a truly decentralized social media protocol that works by posting directly to DNS.

The protocol:

  • Any domain or subdomain is a feed. Say
  • Posts for that feed are TXT records for sequential subdomains starting from 1. eg.,
  • To subscribe to a feed, continuously poll for the next integer subdomain until a TXT record is received.


Get an API key and store it in plain text in a JSON file like

  "key": "KEY",
  "secret": "SECRET"

post using the dns_post function:

dns_post -d -p "I am posting!"

Subscribe using the dns_subscribe function:

dns_subscribe -d

API documentation


usage: dns_post [-h] [-c CREDS] -d DOMAIN -p POST

Post to DNSocial

  -h, --help            show this help message and exit
  -c CREDS, --creds CREDS
                        Location of creds.json file (default is working directory)
  -d DOMAIN, --domain DOMAIN
                        Domain to post to
  -p POST, --post POST  Your post!


usage: subscribe [-h] -d DOMAIN [-i INTERVAL]

Subscribe to a feed on DNS social

  -h, --help            show this help message and exit
  -d DOMAIN, --domain DOMAIN
                        Domain to post to
  -i INTERVAL, --interval INTERVAL
                        Seconds between polling


Yeah it only works with the GoDaddy API, you think i am going to make an arbitrary DNS updating library for a shitpost ya right be my guest.