feed2maildir

Last updated: 2023-09-30 17:02:40 +0100

Upstream URL: git clone http://chriswarbo.net/git/feed2maildir.git

Repo

View repository

View issue tracker

Contents of README follows


Feed2MaildirSimple

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

A simplified fork of Feed2Maildir, which doesn’t use config files or databases.

Requirements

<ul> <li>Python 2.7+ / 3.2+</li> <li>feedparser</li> <li>python-dateutil</li> </ul>

Usage

Run the feed2maildir command. The content of the feed should be sent into the command’s standard input; if the feed is online, you might want to use curl or wget to fetch it. The following options are available:

-h, --help  show this help message and exit (optional)
-m <dir>    maildir location
-n <name>   name to use for this feed
-s          strip HTML from the feeds (optional)

To convert a feed, the -m and -n options are required. Only a single feed will be processed at a time; if you want to process multiple feeds, invoke the command inside a loop.

To prevent the same items being added over and over, each generated maildir entry is given an extra header X-feed2maildirsimple-hash, which stores the given feed name and some stable identifiers from the item. Before creating a new message, the given maildir is scanned for existing hashes, and the item is skipped if a corresponding message already exists.

Once the process has finished, no further work will be performed. If you want to fetch updates at regular intervals, run the command via a system like cron.