Provided by: episoder_0.6.5-1_all bug


       episoder - TV show episode reminder.


       episoder [options]


       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


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

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

              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

              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:


       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


       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


       ~/.episoder - default configuration file


       This manual page was written by Stefan Ott