a simple read-it later app https://pypi.org/project/rdltr/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Sam a005cddd7e update CHANGELOG.md 3 months ago
images README.md update 2 years ago
twootfeed use 'search', since 'search_v1' can be unavailable - fix #25 4 months ago
.gitignore setup.cfg update and packaging prep 1 year ago
.travis.yml update travis ci config 3 months ago
CHANGELOG.md update CHANGELOG.md 3 months ago
LICENCE Create LICENCE 4 years ago
Makefile setup.cfg update and packaging prep 1 year ago
Makefile.config update dependencies 3 months ago
README.md Update badges 9 months ago
VERSION update CHANGELOG.md 3 months ago
setup.cfg update dependencies 3 months ago
setup.py add setup.cfg 1 year ago



generate a rss feed from parsed Twitter or Mastodon search and Mastodon favorites

PyPI version Downloads Python Version Codacy Badge Coverage Status Build Status

The RSS feed displays only the original tweets (not the retweets) and toots, with:

  • links to :
    • the tweet on Twitter or toot on Mastodon
    • hashtags
    • usernames
  • URLs
  • images
  • source
  • location (only for Twitter)
  • numbers of retweets and likes for tweets and boosts and favourites for toots
    (see examples below).


  • Python 3.6+
  • API keys Twitter and/or Mastodon

Installation and configuration

  • Install from pip
$ pip install twootfeed
  • Initialize the configuration file

    $ twootfeed_init
  • Fill in fields for the client(s) you will use in ‘~/.config/twootfeed/config.yml’ :

  • The files location can be changed with the following environment variables:

variable description app default value
TWOOTFEED_CONFIG_DIR configuration and credentials files directory ‘~/.config/twootfeed/’
TWOOTFEED_CONFIG_FILE config file full path config dir + ‘config.yml’ => with default value: ‘~/.config/twootfeed/config.yml’
TWOOTFEED_LOG application log file no default value (log printed on the console)
  • Start the app bash $ twootfeed


The RSS feeds are available on these urls:


Search on Twitter

Twitter search

Results in RSS Feed:
RSS Feed

Display on FreshRSS, a great free self-hosted aggregator (https://github.com/FreshRSS/FreshRSS):

Search on Mastodon

Mastodon search

Results in RSS Feed:
Mastodon Feed

Display on FreshRSS:
Mastodon FreshRSS


see Quick start for developers


Thanks to:

  • georgedorn for adding:
    • rss feed generation with authenticated user’s favorites
    • script to register the app and generate credentials for Mastodon