.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" 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" ''
.    ds C`
.    ds C'
'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 >0, 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.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "TV_GRAB_EU_EPGDATA 1p"
.TH TV_GRAB_EU_EPGDATA 1p "2019-03-01" "perl v5.28.1" "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_eu_epgdata \- Grab TV listings for parts of Europe.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
tv_grab_eu_epgdata \-\-help
tv_grab_eu_epgdata
tv_grab_eu_epgdata \-\-version
.PP
tv_grab_eu_epgdata \-\-capabilities
.PP
tv_grab_eu_epgdata \-\-description
.PP
tv_grab_eu_epgdata [\-\-config\-file \s-1FILE\s0]
                   [\-\-days N] [\-\-offset N]
                   [\-\-output \s-1FILE\s0] [\-\-quiet] [\-\-debug]
.PP
tv_grab_eu_epgdata \-\-configure [\-\-config\-file \s-1FILE\s0]
.PP
tv_grab_eu_epgdata \-\-configure\-api [\-\-stage \s-1NAME\s0]
                   [\-\-config\-file \s-1FILE\s0]
                   [\-\-output \s-1FILE\s0]
.PP
tv_grab_eu_epgdata \-\-list\-channels [\-\-config\-file \s-1FILE\s0]
                   [\-\-output \s-1FILE\s0] [\-\-quiet] [\-\-debug]
.PP
tv_grab_eu_epgdata \-\-preferredmethod
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Output \s-1TV\s0 and listings in \s-1XMLTV\s0 format for many stations
available in Europe.
.PP
First you must run \fBtv_grab_eu_epgdata \-\-configure\fR to choose which stations
you want to receive.
.PP
Then running \fBtv_grab_eu_epgdata\fR with no arguments will get a listings for
the stations you chose for five days including today.
.PP
This is a commercial grabber.
Go to http://wiki.xmltv.org/index.php/EU_epgdata to sign up or
send an e\-mail to service@epgdata.com for further information.
It's also possible to ask for a test account.
.SH "OPTIONS"
.IX Header "OPTIONS"
\&\fB\-\-configure\fR Prompt for which stations to download and write the
configuration file.
.PP
\&\fB\-\-config\-file \s-1FILE\s0\fR Set the name of the configuration file, the
default is \fB~/.xmltv/tv_grab_eu_epgdata.conf\fR.  This is the file written by
\&\fB\-\-configure\fR and read when grabbing.
.PP
\&\fB\-\-gui \s-1OPTION\s0\fR Use this option to enable a graphical interface to be used.
\&\s-1OPTION\s0 may be 'Tk', or left blank for the best available choice.
Additional allowed values of \s-1OPTION\s0 are 'Term' for normal terminal output
(default) and 'TermNoProgressBar' to disable the use of Term::ProgressBar.
.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 5.
.PP
\&\fB\-\-offset N\fR Start grabbing at today + N days.
.PP
\&\fB\-\-quiet\fR Do not show status messages.
.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\-\-version\fR Show the version of the grabber.
.PP
\&\fB\-\-help\fR Print a help message and exit.
.PP
\&\fB\-\-preferredmethod\fR Shows the preferred method for downloading data
                     (see http://wiki.xmltv.org/index.php/XmltvCapabilities)
=head1 \s-1ENVIRONMENT VARIABLES\s0
.PP
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 "SUPPORTED CHANNELS"
.IX Header "SUPPORTED CHANNELS"
For a list of supported channels, see the channel_ids file distributed with this grabber.
If additional channels are available, you will receive a warning when you run \-\-configure.
.PP
Once I am aware that new channels are available, the channel_ids file will be updated and
this grabber will automatically fetch an updated copy.
.SH "COMPATIBILITY"
.IX Header "COMPATIBILITY"
The channel ids used in this grabber aim to be mostly possible with other grabbers, eg
tv_grab_de_prisma and some other grabbers for other countries.
\&\s-1NOTE:\s0 Retaining compatibility was not always possible or practicable.
You can get a list of channel ids using \-\-list\-channels
.SH "AUTHOR"
.IX Header "AUTHOR"
Michael Haas, laga \-at\- laga \-dot\- ath \-dot \- cx. This documentation is copied
from tv_grab_se_swedb by Mattias Holmlund, which in turn was copied from tv_grab_uk by Ed Avis.
Parts of the code are copied from tv_grab_se_swedb and tv_grab_na_dd (in \s-1XMLTV 0.5.45\s0) as well
as various other sources.
.SH "BUGS"
.IX Header "BUGS"
There's no proper support for channels with locally different schedules. For example,
if your \s-1EPG\s0 package is a German one, you'll get the \s-1EPG\s0 schedule for Germany
even if you preferred the Swiss schedule which is also available in the data (for some channels at least).
.PP
Timezones are not handled correctly. Currently, you have to enter your
time zone manually during the configure step. You have to do this every
time your time zone changes, eg for daylight saving time
(\*(L"Sommerzeit\*(R" and \*(L"Normalzeit\*(R" for my fellow Germans).
I'll try to have this fixed for the next \s-1XMLTV\s0 release.
Please see this thread for further discussion and some additional issues:
    http://thread.gmane.org/gmane.comp.tv.xmltv.devel/7919
\&\s-1FYI:\s0 you can modify the time zone directly in the config file which is
usually located at ~/.xmltv/tv_grab_eu_epgdata.conf or
~/.mythtv/FOO.xmltv where \s-1FOO\s0 is the name of your video source in MythTV.
.PP
If the data source gives us data for one day, they'll also cover a part of the following day.
Maybe this should be fixed. Please note: data is not overlapping! So if we want to get data for
today, we might as well grab yesterday because that'll give us \s-1EPG\s0 till ~5am for today.
.PP
I'm sure this list is not complete. Let me know if you encounter additional problems.