debian man page for episoder

EPISODER(1)						      General Commands Manual						       EPISODER(1)

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)