# 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 ##

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

## 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`.