= YaRSS2 =

A RSS plugin for Deluge 1.3 configured through GTKUI

Current features:

 * RSS Feeds with individual update times.
 * Cookie support
 * Sending emails on torrent(s) added, with the list of torrents in the message.
 * Multiple (email message) notifications can be created and applied to different subscriptions.
 * Search using regex, one field for inclusion and one for exclusion. (Maybe some simpler search method should be added?)
 * "Move completed" and "add paused" options.


Features that hopefully will be implement:

 * Log window containing info on what is going on.
 * Label torrents automatically
 * Smart episodes filtering including history to avoid the same episodes being added multiple times.
 * Command line client
 * Better search, maybe a helper to create regex filters.

Tested with Deluge 1.3.4 on:
 * Windows XP
 * Ubuntu 11.04
 * FreeBSD 9 (daemon)


[https://github.com/bendikro/deluge-yarss-plugin/downloads Download] (Windows users need the download ending with ''py2.6.egg'')

[https://github.com/bendikro/deluge-yarss-plugin/tree/development Source]

[https://github.com/bendikro/deluge-yarss-plugin Changelog]

[http://dev.deluge-torrent.org/wiki/Plugins/YaRSS2 Ask for help in the forum thread]

== Getting started ==

=== RSS feed ===

Start by registering a RSS feed in the tab "RSS Feeds". Make sure the links link to torrent files, and not a new HTML page.
The "Update time" is how often this feed is checked. It depends how often the feeds are updated, but usually, between 60-120 should be good. The minimum value is 15 minutes, to avoid overloading the server.

=== Subscription ===
Subscriptions define the content you want to download from a RSS feed.
The search is regex based, which enables extremely powerful search expressions. However, it's not always straight forward to define right.

To help you verify the expression, the list of the current torrents in the RSS feed will show if the torrent matches, and which part of the title that matches

Regex hints:
||Regex||Comment||
||.||any character||
||*||zero or more of the previous||
||.*||zero or more of any character||
||(a|b)|| a or b||

Example 
 * Title1: "My Favourite Series some-random-characters.720p.GROUP"
 * Title2: "My.Favourite.Series.some-random-characters.1080p.GROUP"
 * Title3: "My.Favourite.Series.S1E{01-24}.1080p.GROUP" (where {01-24} is the numbers from 01 to 24)

||Regex||Comment||
||My Favourite Series|| Matches Title1||
||My.Favourite.Series|| Matches all three||
||My.Favourite.Series.*720p|| Matches Title1||
||My.Favourite.Series.*(720p|1080p)|| Matches all three||
||My.Favourite.Series.S01E\d!{2}*1080p|| Matches Title3||