Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

Convert feeds to maildirs

Project description

Read RSS/Atom feeds in your favourite, maildir-compatible email client.


  • Python 2.7+ / 3.2+
  • feedparser
  • python-dateutil


Just run feed2maildir, which should be placed in your $PATH by You will need a JSON configuration file at $HOME/.f2mrc that looks like this:

    "db": "~/.f2mdb",
    "maildir": "~/mail/feeds",
    "feeds": {
        "Coding Horror": "",
        "Commit Strip": "",
        "XKCD": "",
        "What If?": "",
        "Dilbert": "",
        "BSDNow": ""

Note that the last element in a dict must not be followed by a comma, because Python’s json.loads() says so.

There are a bunch of command-line arguments to overwrite the config file:

optional arguments:
    -h, --help  show this help message and exit
    -c <file>   override the config file location (~/.f2mrc)
    -d <file>   override the database file location (~/.f2mdb)
    -m <dir>    override the maildir location (None)
    -s          strip HTML from the feeds
    -l          just write the links without the update

To check for updates regularly, just toss it into cron to run once every hour or so.

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
feed2maildir-0.3.6-py2.py3-none-any.whl (8.1 kB) Copy SHA256 hash SHA256 Wheel py2.py3 Oct 18, 2016
feed2maildir-0.3.6.tar.gz (5.2 kB) Copy SHA256 hash SHA256 Source None Oct 18, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page