NAME

       Canto-fetch - A quiet feed fetcher.

DESCRIPTION

       Canto-fetch  is  designed to be run through a cron job, every minute. Every time it's run,
       it checks the timestamp on each index file and updates the feed, if necessary. The  format
       it  produces  is a simple UTF-8 encoded, NULL delimited text file on disk, readable by the
       canto client.

GETTING STARTED

       Canto-fetch is meant to be used through a cron, adding this  line  to  your  crontab  will
       cause canto-fetch to poll every minute.

       * * * * * canto-fetch

       Alternatively,  if  you're  unable/uncomfortable  using cron, canto-fetch has a background
       daemon mode so you can invoke it in your X session scripts. Just use

       canto-fetch -b

USAGE

       These options correspond to options to the canto client.

       -h / --help
              Print usage and quit.

       -v / --version
              Print version and quit.

       -V / --verbose
              Output status while updating.

       -d / --daemon
              Continue to check for updates every minute. Mostly for  debugging  with  -V,  users
              probably want -b to background.

       -b / --background
              Detach from the terminal (implies -d)

       -f / --force
              Force updates on all feeds, ignoring timestamps.

       -s / --sysfp
              Use feedparser on system instead of builtin copy.

       -C / --conf [PATH]
              Set path to configuration file (default: ~/.canto/conf)

       -F / --fdir [PATH]
              Set path to feed directory (default: ~/.canto/feeds/)

       -L / --log [PATH]
              Set path to log (default: ~/.canto/fetchlog)

       -S / --sdir [PATH]
              Set the path to execurl scripts (default ~/.canto/scripts/)

FILES

       ~/.canto/fetchlog
              Canto-fetch log file.

       ~/.canto/feeds/
              This is the directory where canto-fetch records stories.

BUGS

       None known, but it's not outside of the realm of possibility =P.

HOMEPAGE

       http://codezen.org/canto

AUTHOR

       Jack Miller <jack@codezen.org>