/ 
App-TWatch-Lite-0.02
River stage zero No dependents
/ twatch-lite

NAME

twatch-lite -- periodically polls RSS/ATOM feeds and cherry-picks wanted torrent files

SYNOPSIS

man twatch-lite
mkdir -p ~/.config/twatch-lite
vim ~/.config/twatch-lite/config
twatch-lite --verbose # 1st time, debug

DESCRIPTION

This is very simple and specialized alternative to full-featured software called Twatch. It works only with RSS/ATOM feeds.

Config file

File format is simple: YAML. Real config example:

---
outdir: /tmp
proxy: http://192.168.1.1:3128
feeds:
  - url: http://torrent-tracker.org/rss.php
    linktype: direct
    lookup: title
    matches:
    - 'match substring'
    - '/match regex/'

Now let looks closer: we have a lot of global parameters and section 'feeds'

Global parameters

outdir

Where to save downloaded torrent files. You may want configure your torrent-client to pickup files from this dir. If unset, you'll get warning, and '/tmp' will be used.

proxy

If set - will use http proxy, when fetching rss and torrent-files. Otherwise will connect directly (default).

cookies

If set to any non-empty value, will accept and send back cookies in http-requests. Default - unset.

Section feeds

Configured feeds.

url

URL with RSS/ATOM feed. This option must be set in each feed.

matches

List of wanted 'keywords'. If keyword surrounded with slashes, like /this/, it will be handled as regex, and as substring otherwise. Regex syntax is PCRE and described in perlre(3).

If feed entry matches ANY keyword, torrent file will be downloaded and stored to outdir.

Matches list must contain at least one keyword. If you want all torrents from this feed, use '/.*/' regex keyword.

lookup

Lookup this field in RSS/ATOM entry for wanted keywords. Acceptable values: 'body', 'title' (default).

linktype

Type of link in RSS/ATOM entry. Possible values:

* direct -- link points directly to torrent file (default) * page -- link points to page with link to torrent file (not implemented yet)

SEE ALSO

Twatch

AUTHORS

Alex 'AdUser' Z <aduser@cpan.org>