synack / rssnzb

DESCRIPTION
--------------------------------------------------------------------------------
Automatically download NZBs matching a given pattern from an RSS feed. Intended
to be used with hellanzb and tvnzb feeds.

REQUIREMENTS
--------------------------------------------------------------------------------
 - A recent Python. Tested with 2.5, but older versions may work as well
 - feedparser (http://feedparser.org/)
 - Some program that will download NZBs placed in a directory. I use hellanzb

INSTALLATION
--------------------------------------------------------------------------------
 - Copy rssnzb.py to your system.
 - Edit the settings at the top of the file
 - Create the directory you pointed RSSNZB_DIR to
 - Create two empty files in that directory named "downloaded" and "patterns"
 - Make sure the user that will run rssnzb has write access to "downloaded" and
   DOWNLOAD_DIR
 - Create a list of regex patterns and put them in "patterns". One pattern per
   line.
 - Create a cron job to run at whatever interval suits your needs, no more often
   than once an hour (otherwise you might annoy the web server admin)
   @hourly /path/to/rssnzb.py

NOTES
--------------------------------------------------------------------------------
The "downloaded" file contains a list of all NZBs that have already been
downloaded. This is to prevent NZBs from getting downloaded twice. It's hackish
and doesn't scale well, but it works.

If you're using tvnzb's feed you'll probably want to match on the beginning of
the title. For example, if you wanted to grab all episodes of The Simpsons, you
would write a pattern like this:
^The.Simpsons
tvnzb tends to be fairly consistent in their naming of the files, so you
shouldn't have too much trouble coming up with a list of patterns that works.

TODO
--------------------------------------------------------------------------------
There isn't any error checking. Somebody should fix that.