Feed Digest

Feed Digest is an ultra-minimalist, but efficient feed reader of RSS and Atom feeds. It consists of two commands for feeds downloading and generating of HTML digest optimized for fast titles overviewing.

Dependencies

• Python 2+
• Universal Feed Parser. Available as feedparser Python package and python-feedparser package on some Linux distos.
• (optional) any static web server if you would like to serve the generated webpages.
• (optional) support for SSI (server-side includes) on a web server for storing the last read page. For example, Apache with mod_include module, nginx with ngx_http_ssi_module module.

Screenshots

Index page:

Hourly entries:

Usage

1. Clone or copy this repository to some place on your server, e.g. ~/feed-digest.
2. Copy config.example.py to config.py, adjust its values if needed.
3. Copy urls.example to urls, fill it with your feed urls, start comments with #, optionally provide custom feed title after url separating with space.
4. Open crontab using crontab -e and edit cronjob to it like */20 * * * * cd ~/feed-digest; ./download && ./generate
5. Symlink directory with generated HTML files to webserver root: sudo ln -s ~/feed-digest/www/ /var/www/feeds
6. Your Feed Digest will be available for reading by http://yourserver/feeds/.

Similar projects

• FeedHQ
• Litenin
• Miniflux
• feeds
• moonmoon
• rawdog

License and copyright

The project is released under the General Public License (GPL), version 3.

Copyright © 2015, Danil Semelenov.