feed2exec - programmable feed reader¶
feed2exec is a simple program that runs custom actions on new RSS
feed items (or whatever feedparser can read). It currently has
support for writing into mailboxes (Maildir folders) or executing
commands, but more actions can be easily implemented through
plugins. Email are saved as multipart plain/HTML and can be sent to
The user interface is still a bit rough, but this should get you started:
feed2exec add "NASA breaking news" https://www.nasa.gov/rss/dyn/breaking_news.rss --folder nasa feed2exec fetch
An equivalent configuration file which may be more descriptive in
[DEFAULT] output = feed2exec.plugins.maildir mailbox = '~/Maildir' [NASA breaking news] folder = nasa url = https://www.nasa.gov/rss/dyn/breaking_news.rss
Using a standard OPML file, you can also import multiple feeds using the feed2exec import command. See the complete feed2exec manual page page for more information.
This can be installed using the normal Python procedures:
pip install .
It can also be ran straight from the source, using:
python -m feed2exec
Make sure you use Python 3. feed2exec is written to also support Python 2.7, but there may be performance or security issues in that older version. For example, Python 2.7 seems to suffer from a header injection flaw that currently makes tests fail.
Why the name?¶
- API documentation