Skip to main content

This command will take a configured set of feeds andfire specific commands or plugins for every new item found in the feed.

Project description

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 arbitrary folders.


The user interface is still a bit rough, but this should get you started:

feed2exec add "NASA breaking news" --folder nasa
feed2exec fetch

An equivalent configuration file which may be more descriptive in ~/.config/feed2exec/feed2exec.ini:

output = feed2exec.plugins.maildir
mailbox = '~/Maildir'

[NASA breaking news]
folder = nasa
url =

Using a standard OPML file, you can also import multiple feeds using the feed2exec import command. See the complete usage 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?

There are already feed2tweet and feed2imap out there so I figured I would just reuse the prefix and extend both programs at once.

Design and known issues

See the design document for more information about how and why the program was built and its limitations. The design document also features a comparison with other similar software.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for feed2exec, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size feed2exec-0.2.1-py3-none-any.whl (36.5 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page