Skip to main content

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
feed2maildir-0.3.6.tar.gz (5.2 kB) Copy SHA256 hash SHA256 Source None

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