twootfeed 0.6.1

generate a rss feed from Twitter or Mastodon search

python-twootfeed

generate a rss feed from parsed Twitter or Mastodon search and Mastodon favorites, using Flask.

---

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

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

Requirements

• 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' :

  • for Twitter : see https://apps.twitter.com
    copy/paste the Twitter API key values in config.yml file ('consumerKey' and 'consumerSecret')
  • for Mastodon : see Python wrapper for the Mastodon API
    use the included script which will register your app and prompt you to log in, creating the credential files for you.

  $ twootfeed_create_mastodon_cli
  

  If needed, update the feed and app parameters.

• 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

$ twootfeed

Usage

The RSS feeds are available on these urls:

• for Twitter: http://localhost:8080/_keywords_ or http://localhost:8080/tweets/_keywords_
• for Mastodon:
  • search: http://localhost:8080/toots/_keywords_
  • connected user favorites: http://localhost:8080/toot_favorites

Examples

Search on Twitter

Results in RSS Feed:

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

Search on Mastodon

Results in RSS Feed:

Display on FreshRSS:

Contribute

see Quick start for developers

Contributors

Thanks to:

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