Provided by: episoder_0.6.5-1_all bug

NAME

       episoder - TV show episode reminder.

SYNOPSIS

       episoder [options]

DESCRIPTION

       episoder is a tool to tell you about new episodes of your favourite TV shows

Global options

       -h     Show help and quit.

       -c FILE
              Use FILE for configuration values (default is ~/.episoder).

       -b     Update episoder's database

       -B     Force-update the database, disregard information on when shows were last updated

       -v     Enable verbose operation

       -w     Enable very verbose (debug) operation

       -V     Show program version and quit

       -p     Show available parsers

       -l FILE
              Log to FILE instead of stdout

Options for database update

       -d [YYYY-MM-DD]
              Remove episodes prior to this date (default: yesterday)

       -d NUM Remove episodes that aired more than NUM days ago (default: 1)

       -i     Ignore date (don't remove old episodes), overrules -d

       -f FILE
              Get data from FILE, ignore configured sources (needs -P)

       -P PARSER
              Force PARSER to be used (only in combination with -f)

Managing shows

       -L     Display a list of all shows in episoder's database

       -a URL Add the show located at URL to the database

       -r ID  Remove the show with the number ID from the database

       -E ID  Enable updates for the show with the number ID

       -D ID  Disable updates for the show with the number ID

Options for console output

       -d [YYYY-MM-DD]
              Only show episodes newer than date (default: yesterday)

       -d NUM Only show episodes that are less then NUM days old (default: 1)

       -i     Ignore date (overrules -d and -n)

       -n DAYS
              Number  of future DAYS to show (default: 2). This value is relative to the date set
              with -d.

       -s TEXT
              Search the database for TEXT

       -C     Don't show any colors in the output

CONFIG FILE

       The configuration file consists of a section with settings for the program and a  list  of
       sources to be used to build the database.

       agent=foo
              Set  the  user-agent  string  to  be used by wget (was required when tvtome blocked
              wget, might not be needed nowadays)

       data=/path/to/file
              Specifies the file to be used to store the information about  upcoming  shows.  If,
              instead  of  a  file,  you  supply  a  database url (as expected by sqlalchemy, eg.
              'mysql://localhost/episoder'), episoder is going to use that database  for  storage
              instead.

       src=http://some.web.add/ress
              Each  src  entry  specifies  a URL with episode information. Make sure you have the
              appropriate plugin  before  adding  random  new  URLs  (check  with  -p).  Episoder
              currently understands the following types of source:

               src=http://www.epguides.com/CSI/
               src=http://www.tv.com/CSI/show/19/

       While  this  in  no  longer episoder's way of knowing which shows to parse (see ``Managing
       shows''), for compatibility reasons all shows listed in the config file will automatically
       be added to episoder's show database (as if specified with -a).

       format=unquoted format string
              This allows you to customize episoder's output. Available fields are:

               %airdate     The episode's airdate as YYYY-MM-DD
               %show        Name of the show
               %season      Current season
               %epnum       Episode's number in season
               %eptitle     Title of the episode
               %totalep     Episode's total number
               %prodnum     Production number

       If  undefined,  the  default  value of %airdate %show %seasonx%epnum (eg. "2005-07-29 Monk
       4x04") is used.

       dateformat=unquoted string describing the format
              Here you can define the date format you'd like to be used for the output. To get  a
              list of all possible fields, see date(1).

              The default is %a, %b %d, %Y

CRON

       You  might  want  to  have  your  episode db rebuilt on a regular basis (i.e. daily).  The
       easiest way to achieve this is with a simple cron job:

           crontab -l > crontab
           echo "40 5 * * * episoder -b" >> crontab
           crontab crontab

FILES

       ~/.episoder - default configuration file

AUTHOR

       This manual page was written by Stefan Ott

SEE ALSO

       crontab(1).

                                                                                      EPISODER(1)