.\" 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_FR_KAZER 1p"
.TH TV_GRAB_FR_KAZER 1p "2011-06-19" "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_fr_kazer \- Grab TV listings from Kazer in France.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
tv_grab_fr_kazer \-\-help
.PP
tv_grab_fr_kazer \-\-configure [\-\-config\-file \s-1FILE\s0] [\-\-root\-url \s-1URL\s0]
.PP
tv_grab_fr_kazer [\-\-config\-file \s-1FILE\s0] [\-\-root\-url \s-1URL\s0]
[\-\-days N] [\-\-offset N] [\-\-channel xmltvid,xmltvid,...]
[\-\-output \s-1FILE\s0] [\-\-quiet] [\-\-debug]
.PP
tv_grab_fr_kazer \-\-list\-channels [\-\-config\-file \s-1FILE\s0] [\-\-root\-url \s-1URL\s0]
[\-\-output \s-1FILE\s0] [\-\-quiet] [\-\-debug]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Output \s-1TV\s0 and listings in \s-1XMLTV\s0 format for many stations
available in France. This program consumes the \s-1EPG\s0 service offering
from Kazer at .
See \s-1TODO\s0 \s-1INSERTLINKHERE\s0
for their terms of service. (automatic translation suggests it's free
for personal use, verfication appreciated)
.PP
First you must register an account at kazer.org and choose which stations
you want to receive.
.PP
Then run \fBtv_grab_fr_kazer \-\-configure\fR to setup the grabber with your
userhash and maybe filter the channels. (in case you feed multiple
consumers with data from one account, like using different configurations
for tv cable and iptv channels)
.PP
After these two steps running \fBtv_grab_fr_kazer\fR with no arguments will
get a listings for the stations you chose for all available days
including today.
.PP
\&\s-1ATTENTION:\s0 The downloaded data is cached for one hour, so if you add channels
to your account it can take up to one hour until they are returned from the
grabber. You can remove the downloaded guide to force an immediate refresh
by deleteing the guide from the supplementry file cache. On Unix like system
it is by default at ~/.xmltv/supplement/tvguide.zip?u=.
.SH "OPTIONS"
.IX Header "OPTIONS"
\&\fB\-\-configure\fR Prompt for which stations to download and write the
configuration file.
.PP
Note that due to the format of the source data, tv_grab_fr_kazer always
downloads data for all channels that have been selected on kazer.org.
Removing channels from the configuration in order to speed up downloads or
reduce data transfer will therefore not work.
.PP
\&\fB\-\-config\-file \s-1FILE\s0\fR Set the name of the configuration file, the
default is \fB~/.xmltv/tv_grab_fr_kazer.conf\fR. This is the file written by
\&\fB\-\-configure\fR and read when grabbing.
.PP
\&\fB\-\-output \s-1FILE\s0\fR When grabbing, write output to \s-1FILE\s0 rather than
standard output.
.PP
\&\fB\-\-days N\fR When grabbing, grab N days rather than everything available.
.PP
\&\fB\-\-offset N\fR Start grabbing at today + N days.
.PP
Note that due to the format of the source data, tv_grab_fr_kazer always
downloads data for all available days and then filters for days specified
with \-\-days and \-\-offset. Specifying \-\-days and/or \-\-offset in order to
speed up downloads or reduce data transfer will therefore not work.
.PP
\&\fB\-\-quiet\fR Only print error-messages on \s-1STDERR\s0.
.PP
\&\fB\-\-debug\fR Provide more information on progress to stderr to help in
debugging.
.PP
\&\fB\-\-list\-channels\fR Output a list of all channels that data is available
for. The list is in xmltv-format.
.PP
\&\fB\-\-capabilities\fR Show which capabilities the grabber supports. For more
information, see
.PP
\&\fB\-\-version\fR Show the version of the grabber.
.PP
\&\fB\-\-help\fR Print a help message and exit.
.SH "ERROR HANDLING"
.IX Header "ERROR HANDLING"
If the grabber fails to download data from kazer.org, it will print an
errormessage to \s-1STDERR\s0 and then exit with a status code of 1 to indicate
that the data is missing.
.SH "ENVIRONMENT VARIABLES"
.IX Header "ENVIRONMENT VARIABLES"
The environment variable \s-1HOME\s0 can be set to change where configuration
files are stored. All configuration is stored in \f(CW$HOME\fR/.xmltv/. On Windows,
it might be necessary to set \s-1HOME\s0 to a path without spaces in it.
.SH "CREDITS"
.IX Header "CREDITS"
Grabber written by Karl Dietz, dekarl \-at\- users \-dot\- sourceforge \-dot\- net
as a an example on how to wrap a file download into a well formed grabber.
This documentation copied from tv_grab_cz by Mattias Holmlund,
This documentation copied from tv_grab_uk by Ed Avis,
ed \-at\- membled \-dot\- com. Original grabber by Jiri Kaderavek,
jiri \-dot\- kaderavek \-at\- webstep \-dot\- net with modifications by
Petr Stehlik, pstehlik \-at\- sophics \-dot\- cz.
.PP
Data provided via web service from kazer.org. Check their terms of usage!
.SH "BUGS"
.IX Header "BUGS"
None known.