.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "TV_GRAB_FI 1p"
.TH TV_GRAB_FI 1p "2012-06-30" "perl v5.14.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
tv_grab_fi \- Grab TV listings for Finland
.SH "SYNOPSIS"
.IX Header "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]
.PP
tv_grab_fi  \-\-capabilities
.PP
tv_grab_fi  \-\-configure
           [\-\-cache <\s-1FILE\s0>]
           [\-\-config\-file <\s-1FILE\s0>]
           [\-\-gui [<\s-1OPTION\s0>]]
           [\-\-quiet]
.PP
tv_grab_fi  \-\-description
.PP
tv_grab_fi  \-\-help|\-h|\-?
.PP
tv_grab_fi  \-\-list\-channels
           [\-\-cache <\s-1FILE\s0>]
           [\-\-gui [<\s-1OPTION\s0>]]
           [\-\-quiet]
.PP
tv_grab_fi  \-\-version
.SH "DESCRIPTION"
.IX Header "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.
.PP
You need to run \f(CW\*(C`tv_grab_fi \-\-configure\*(C'\fR first to create the channel
configuration for your setup. Subsequently runs of \f(CW\*(C`tv_grab_fi\*(C'\fR will grab
the latest data, process them and produce \s-1XML\s0 data on the standard output.
.SH "COMMANDS"
.IX Header "COMMANDS"
.IP "\fB\s-1NONE\s0\fR" 8
.IX Item "NONE"
Grab mode.
.IP "\fB\-\-capabilities\fR" 8
.IX Item "--capabilities"
Show the capabilities this grabber supports. See also
<http://wiki.xmltv.org/index.php/XmltvCapabilities>.
.IP "\fB\-\-configure\fR" 8
.IX Item "--configure"
Generate the configuration file by asking the users which channels to grab.
.IP "\fB\-\-description\fR" 8
.IX Item "--description"
Print the description for this grabber.
.IP "\fB\-\-help|\-h|\-?\fR" 8
.IX Item "--help|-h|-?"
Show this help page.
.IP "\fB\-\-list\-channels\fR" 8
.IX Item "--list-channels"
Fetch all available channels from the various sources and write them to the
standard output.
.IP "\fB\-\-version\fR" 8
.IX Item "--version"
Show the version of this grabber.
.SH "GENERIC OPTIONS"
.IX Header "GENERIC OPTIONS"
.IP "\fB\-\-cache \f(BI\s-1FILE\s0\fB\fR" 8
.IX Item "--cache FILE"
File name to cache the fetched \s-1HTML\s0 data in. This speeds up subsequent runs
using the same data.
.IP "\fB\-\-gui [\s-1OPTION\s0]\fR" 8
.IX Item "--gui [OPTION]"
Enable the graphical user interface. If you don't specify \fB\s-1OPTION\s0\fR then
\&\s-1XMLTV\s0 will automatically choose the best available \s-1GUI\s0. Allowed values are:
.RS 8
.IP "\fBTerm\fR" 4
.IX Item "Term"
Terminal output with a progress bar
.IP "\fBTermNoProgressBar\fR" 4
.IX Item "TermNoProgressBar"
Terminal output without progress bar
.IP "\fBTk\fR" 4
.IX Item "Tk"
Tk-based \s-1GUI\s0
.RE
.RS 8
.RE
.IP "\fB\-\-quiet\fR" 8
.IX Item "--quiet"
Suppress any progress messages to the standard output.
.SH "CONFIGURE MODE OPTIONS"
.IX Header "CONFIGURE MODE OPTIONS"
.IP "\fB\-\-config\-file \f(BI\s-1FILE\s0\fB\fR" 8
.IX Item "--config-file FILE"
File name to write the configuration to.
.Sp
Default is \fI\f(CI$HOME\fI/.xmltv/tv_grab_fi.conf\fR.
.SH "GRAB MODE OPTIONS"
.IX Header "GRAB MODE OPTIONS"
.IP "\fB\-\-config\-file \f(BI\s-1FILE\s0\fB\fR" 8
.IX Item "--config-file FILE"
File name to read the configuration from.
.Sp
Default is \fI\f(CI$HOME\fI/.xmltv/tv_grab_fi.conf\fR.
.ie n .IP "\fB\-\-days \fB""N""\fB\fR" 8
.el .IP "\fB\-\-days \f(CBN\fB\fR" 8
.IX Item "--days N"
Grab \f(CW\*(C`N\*(C'\fR days of \s-1TV\s0 data.
.Sp
Default is 14 days.
.ie n .IP "\fB\-\-offset \fB""N""\fB\fR" 8
.el .IP "\fB\-\-offset \f(CBN\fB\fR" 8
.IX Item "--offset N"
Grab \s-1TV\s0 data starting at \f(CW\*(C`N\*(C'\fR days in the future.
.Sp
Default is 0, i.e. today.
.IP "\fB\-\-output \f(BI\s-1FILE\s0\fB\fR" 8
.IX Item "--output FILE"
Write the \s-1XML\s0 data to \fI\s-1FILE\s0\fR instead of the standard output.
.SH "CONFIGURATION FILE SYNTAX"
.IX Header "CONFIGURATION FILE SYNTAX"
The configuration file is line oriented, each line can contain one command.
Empty lines and everything after the \f(CW\*(C`#\*(C'\fR comment character is ignored.
Supported commands are:
.IP "\fBchannel \s-1ID\s0 \s-1NAME\s0\fR" 8
.IX Item "channel ID NAME"
Grab information for this channel. \f(CW\*(C`ID\*(C'\fR depends on the source, \f(CW\*(C`NAME\*(C'\fR 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.
.IP "\fBseries description \s-1NAME\s0\fR" 8
.IX Item "series description NAME"
If a programme title matches \f(CW\*(C`NAME\*(C'\fR then the first sentence of the
description, i.e. everything up to the first period (\f(CW\*(C`.\*(C'\fR), question mark
(\f(CW\*(C`?\*(C'\fR) or exclamation mark (\f(CW\*(C`!\*(C'\fR), is removed from the description and is used
as the name of the episode.
.IP "\fBseries title \s-1NAME\s0\fR" 8
.IX Item "series title NAME"
If a programme title contains a colon (\f(CW\*(C`:\*(C'\fR) then the grabber checks if the
left-hand side of the colon matches \f(CW\*(C`NAME\*(C'\fR. If it does then the left-hand
side is used as programme title and the right-hand side as the name of the
episode.
.ie n .IP "\fBtitle map ""\s-1FROM\s0"" '\s-1TO\s0'\fR" 8
.el .IP "\fBtitle map ``\s-1FROM\s0'' '\s-1TO\s0'\fR" 8
.IX Item "title map FROM 'TO'"
If the programme title starts with the string \f(CW\*(C`FROM\*(C'\fR then replace this part
with the string \f(CW\*(C`TO\*(C'\fR. The strings must be enclosed in single quotes (\f(CW\*(C`\*(Aq\*(C'\fR) or
double quotes (\f(CW\*(C`"\*(C'\fR). The title mapping occurs before the \f(CW\*(C`series\*(C'\fR command
processing.
.IP "\fBtitle strip parental level\fR" 8
.IX Item "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. \f(CW\*(C`(S)\*(C'\fR. With this command all
parental levels will be removed from the titles automatically. This removal
occurs before the title mapping.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
xmltv.
.SH "AUTHORS"
.IX Header "AUTHORS"
.SS "Current"
.IX Subsection "Current"
.ie n .IP "Stefan Becker ""stefan dot becker at nokia dot com""" 4
.el .IP "Stefan Becker \f(CWstefan dot becker at nokia dot com\fR" 4
.IX Item "Stefan Becker stefan dot becker at nokia dot com"
.PD 0
.ie n .IP "Ville Ahonen ""ville dot ahonen at iki dot fi""" 4
.el .IP "Ville Ahonen \f(CWville dot ahonen at iki dot fi\fR" 4
.IX Item "Ville Ahonen ville dot ahonen at iki dot fi"
.PD
.SS "Retired"
.IX Subsection "Retired"
.IP "Matti Airas" 4
.IX Item "Matti Airas"
.SH "BUGS"
.IX Header "BUGS"
The channels are identified by channel number rather than the \s-1RFC2838\s0 form
recommended by the \s-1XMLTV\s0 \s-1DTD\s0.