| 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 showsGlobal 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
- 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