SYNOPSIS

tv_grab_fi [--cache <\s-1FILE\s0>]

           [--config-file <\s-1FILE\s0>]
           [--days <N>]
           [--gui [<\s-1OPTION\s0>]]
           [--offset <N>]
           [--output <\s-1FILE\s0>]
           [--quiet]

tv_grab_fi --capabilities

tv_grab_fi --configure

           [--cache <\s-1FILE\s0>]
           [--config-file <\s-1FILE\s0>]
           [--gui [<\s-1OPTION\s0>]]
           [--quiet]

tv_grab_fi --description

tv_grab_fi --help|-h|-?

tv_grab_fi --list-channels

           [--cache <\s-1FILE\s0>]
           [--gui [<\s-1OPTION\s0>]]
           [--quiet]

tv_grab_fi --version

DESCRIPTION

Grab \s-1TV\s0 listings for several channels available in Finland. The data comes from various sources, e.g. www.telkku.com. The grabber relies on parsing \s-1HTML\s0, so it might stop working when the web page layout is changed.

You need to run \*(C`tv_grab_fi --configure\*(C' first to create the channel configuration for your setup. Subsequently runs of \*(C`tv_grab_fi\*(C' will grab the latest data, process them and produce \s-1XML\s0 data on the standard output.

COMMANDS

\s-1NONE\s0

Grab mode.

--capabilities

Show the capabilities this grabber supports. See also <http://wiki.xmltv.org/index.php/XmltvCapabilities>.

--configure

Generate the configuration file by asking the users which channels to grab.

--description

Print the description for this grabber.

--help|-h|-?

Show this help page.

--list-channels

Fetch all available channels from the various sources and write them to the standard output.

--version

Show the version of this grabber.

GENERIC OPTIONS

--cache \s-1FILE\s0

File name to cache the fetched \s-1HTML\s0 data in. This speeds up subsequent runs using the same data.

--gui [\s-1OPTION\s0]

Enable the graphical user interface. If you don't specify \s-1OPTION\s0 then \s-1XMLTV\s0 will automatically choose the best available \s-1GUI\s0. Allowed values are:

Term

Terminal output with a progress bar

TermNoProgressBar

Terminal output without progress bar

Tk

Tk-based \s-1GUI\s0

--quiet

Suppress any progress messages to the standard output.

CONFIGURE MODE OPTIONS

--config-file \s-1FILE\s0

File name to write the configuration to. Default is $HOME/.xmltv/tv_grab_fi.conf.

GRAB MODE OPTIONS

--config-file \s-1FILE\s0

File name to read the configuration from. Default is $HOME/.xmltv/tv_grab_fi.conf. Grab \*(C`N\*(C' days of \s-1TV\s0 data. Default is 14 days. Grab \s-1TV\s0 data starting at \*(C`N\*(C' days in the future. Default is 0, i.e. today.

--output \s-1FILE\s0

Write the \s-1XML\s0 data to \s-1FILE\s0 instead of the standard output.

CONFIGURATION FILE SYNTAX

The configuration file is line oriented, each line can contain one command. Empty lines and everything after the \*(C`#\*(C' comment character is ignored. Supported commands are:

channel \s-1ID\s0 \s-1NAME\s0

Grab information for this channel. \*(C`ID\*(C' depends on the source, \*(C`NAME\*(C' is ignored and forwarded as is to the \s-1XMLTV\s0 output file. This information can be automatically generated using the grabber in the configuration mode.

series description \s-1NAME\s0

If a programme title matches \*(C`NAME\*(C' then the first sentence of the description, i.e. everything up to the first period (\*(C`.\*(C'), question mark (\*(C`?\*(C') or exclamation mark (\*(C`!\*(C'), is removed from the description and is used as the name of the episode.

series title \s-1NAME\s0

If a programme title contains a colon (\*(C`:\*(C') then the grabber checks if the left-hand side of the colon matches \*(C`NAME\*(C'. If it does then the left-hand side is used as programme title and the right-hand side as the name of the episode. If the programme title starts with the string \*(C`FROM\*(C' then replace this part with the string \*(C`TO\*(C'. The strings must be enclosed in single quotes (\*(C`'\*(C') or double quotes (\*(C`"\*(C'). The title mapping occurs before the \*(C`series\*(C' command processing.

title strip parental level

At the beginning of 2012 some programme descriptions started to include parental levels at the end of the title, e.g. \*(C`(S)\*(C'. With this command all parental levels will be removed from the titles automatically. This removal occurs before the title mapping.

RELATED TO tv_grab_fi…

xmltv.

AUTHORS

Current

Retired

Matti Airas

BUGS

The channels are identified by channel number rather than the \s-1RFC2838\s0 form recommended by the \s-1XMLTV\s0 \s-1DTD\s0.