SYNOPSIS

spicylinks [options]

DESCRIPTION

A shameless copy of http://dev.upian.com/hotlinks/ , with less features and no web UI -- but with the source code, and with the ability for you to specify what feeds you want to aggregate.

OPTIONS

--feeds file.opml
The OPML file to load the source feed-list from. Note that only the RSS/Atom URLs for link-blogs should be listed in the file.

--maxitems num
The maximum number of items to output in each output RSS feed.

--timelimit num
How ``fresh'' should an item be, for it to be included? Specified in hours. Items that don't declare a date in the source feed, are considered to have been posted right now.

--dump
Dump all (parsed) XML structures using Data::Dumper, for debugging.

CACHING

Yes, it does -- in the $HOME/.leechrss directory. (This is an artifact of my other web-scraping scripts which also use that dir.)

RSS files are cached for as long as LWP says they should be cached; see the documentation for the HTTP::Response freshness_lifetime method.

USAGE

Here's the line I use in my ``crontab'' file to run the script every 30 minutes:

  10,40 * * * * /home/jm/DIR/spicylinks/spicylinks.pl --feeds /home/jm/DIR/spicylinks/feeds.opml > /home/jm/DIR/spicylinks/LOG 2>&1

Standard stuff.

LICENSE

GPL

PREREQUISITES

The following CPAN modules must be installed:

  WWW::Mechanize XML::Simple XML::RSS MIME::Base64 HTML::Entities Date::Parse
  Template 
  
optionally:
  Time::Duration -- to produce nice "3 hours ago" readable timestamps

AUTHOR

Justin Mason, jm at jmason dot org

VERSION

1.0 Oct 18 2005 jm