Decentralised, minimalist microblogging service for hackers.
Go to file
buckket fe31c32d82
Merge pull request #156 from sorenpeter/patch-1
Adding link to phpub2twtxt by sorenpeter
2021-01-24 22:01:33 +01:00
docs Update installation.rst 2020-09-24 18:49:30 -07:00
tests Ask user for twturl in twtxt quickstart (closes #116) 2016-04-07 12:42:34 +02:00
twtxt This is 1.2.3 2017-09-28 18:09:01 +02:00
.gitignore Ignore vim swap files in git 2016-02-16 22:41:30 -08:00
.travis.yml Make sure we always have the latest pytest version installed 2016-02-10 20:47:10 +01:00
AUTHORS This is 1.2.0 2016-02-12 18:44:02 +01:00
CHANGES This is 1.2.3 2017-09-28 18:09:01 +02:00 Update 2016-02-11 01:37:49 +01:00
LICENSE This is 1.2.2 2017-09-27 00:51:54 +02:00 Update 2016-03-30 20:35:25 +02:00
Makefile Switch to twine for uploading to PyPI 2017-09-27 15:39:00 +02:00
README.rst Adding link to phpub2twtxt by sorenpeter 2021-01-22 18:21:56 +01:00
config.example Adding option to specify minimal interval between checks (closes #100) 2016-03-30 21:26:03 +02:00 Be more explicit about our dependencies, no major update pls 2017-09-27 00:46:43 +02:00
tox.ini Add support for testing with multiple Python versions via tox 2016-02-09 14:08:35 +01:00



Latest version released on PyPi Build status of the master branch Test coverage Documentation Status Package license

twtxt is a decentralised, minimalist microblogging service for hackers.

So 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.


tl;dr: twtxt is a CLI tool, as well as a format specification for self-hosted flat file based microblogging.


  • A beautiful command-line interface thanks to click.
  • Asynchronous HTTP requests thanks to asyncio/aiohttp and Python 3.
  • Integrates well with existing tools (scp, cut, echo, date, etc.) and your shell.
  • Dont like the official client? Tweet using echo -e "`date +%FT%T%:z`\tHello world!" >> twtxt.txt!


Check out the full documentation at:




twtxt is released under the MIT License. See the bundled LICENSE file for details.