From IndieWeb
Jump to: navigation, search

twtxt is a decentralised, minimalist microblogging service for hackers.

It is a CLI tool, as well as a format specification for self-hosted flat file based microblogging.


You want to get some thoughts out on the internet in a convenient and slick way while also following the gibberish of others? Instead of signing up at a closed and/or regulated microblogging platform, getting your status updates out with twtxt is as easy as putting them in a publicly accessible text file. The URL pointing to this file is your identity, your account. twtxt then tracks these text files, like a feedreader, and builds your unique timeline out of them, depending on which files you track. The format is simple, human readable, and integrates well with UNIX command line utilities.


  • A command-line interface thanks to click.
  • Asynchronous HTTP requests thanks to asyncio/aiohttp and Python 3.
  • Integrates with existing tools (scp, cut, echo, date, etc.) and your shell.
  • Tweet using echo -e "`date -Im`\tHello world!" >> twtxt.txt!


  • List of users and bots:

Example Feeds


The Hallway

The Hallway is a decentralized forum using twtxt feeds.

twtxt clients

txtnish - A twtxt client with minimal dependencies