A Python parser to tweet the latest updates from multiple RSS feeds.
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 56 commits ahead of manvari:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



feedr is a non-asynchronous, WTFPLv2-licensed Python parser to tweet the latest updates from multiple RSS feeds.

Sorry, what does it do?

feedr tweets the newest element from a RSS feed to the Twitter account of your choice, and stores it in a database.

It's pretty easy: you feed it with a list with links to RSS feeds, then it does a bit of formatting to create a nice, readable message, and it tweets it.

A note on feedr's behaviour

feedr tries to stick as much as possible to the RSS feeds it handles but avoids redundancy, all of this without taking too much system resources.

To keep it simple and do just that, it will only care about the latest element in a RSS feed. If it is found to be a duplicate of the last (n-1) element that feedr has already handled, then it will only keep this new element and delete the previous one on Twitter (and in the database).

Not convinced?

If you're unsure whether feedr is the solution you need, check out this Twitter account which uses feedr.


feedr can either be installed through pip (stable version) or manually (dev or stable version).

Using pip:

$ (sudo) pip install py-feedr  


  • Stable version: download the latest release version
  • Development version: clone this git repository ($ git clone https://github.com/M157q/py-feedr.git)

Then run $ (sudo) python setup.py install to install imgur-scraper.


Installation requirements:

Runtime requirements:


feedr needs to be given an INI configuration file, which contains amongst other parameters a path to a JSON feedlist of RSS feeds that follows the example format.

Then simply invoke feedr:

usage: feedr [-h] config  
positional arguments:  
  config      path to the feedr configuration file  
  optional arguments:  
    -h, --help  show this help message and exit  

You can setup a cron job that runs every minute if you need to call feedr regularly:
*/1 * * * * /usr/bin/bash -c "/usr/bin/python3 /home/feedr/feedr cfg.ini" >> /home/feedr/feedr.log 2>&1


py-feedr is licensed under the WTFPLv2 license; refer to the LICENSE file.