TV_GRAB_UK_GUARDIAN(1)User Contributed Perl DocumentatioTV_GRAB_UK_GUARDIAN(1)NAMEtv_grab_uk_guardian - Grab TV listings for UK from The Guardian
website.
DESCRIPTION
Output TV listings in XMLTV format for many channels available in UK.
The data come from <http://theguardian.co.uk>
First you must run tv_grab_uk_guardian--configure to choose which
channels you want to receive.
Then running tv_grab_uk_guardian with no arguments will get a listings
in XML format for the channels you chose for available days including
today.
OPTIONS
Please see tv_grab_uk_guardian--help
INSTALLATION
The file tv_grab_uk_guardian.map.conf has two purposes. Firstly you
can map the channel ids used by the site into something more meaningful
to your PVR. E.g.
map==bbc-1-south==BBC 1
will change "bbc-1-south" to "BBC 1" in the output XML.
Note: the lines are of the form "map=={channel id}=={my name}".
The second purpose is to likewise translate genre names. So if your
PVR doesn"t have a category for "Science Fiction" but uses "Sci-fi"
instead, then you can specify
cat==Science Fiction==Sci-fi
and the output XML will have "Sci-fi".
IMPORTANT: the downloaded "tv_grab_uk_guardian.map.conf" contains
example lines to illustrate the format - you should edit this file to
suit your own purposes!
ERROR HANDLING
If the grabber fails to download data for some channel on a specific
day, it will print an errormessage to STDERR and then continue with the
other channels and days. The grabber will exit with a status code of 1
to indicate that the data is incomplete.
ENVIRONMENT VARIABLES
The environment variable HOME can be set to change where configuration
files are stored. All configuration is stored in $HOME/.xmltv/. On
Windows, it might be necessary to set HOME to a path without spaces in
it.
SUPPORTED CHANNELS
For information on supported channels, see
<http://tvlistings.guardian.co.uk/text-only/all-channels/>
XMLTV VALIDATION
tv_validate_grabber may report an error similar to:
"Line 5 Invalid channel-id BBC 1"
This is a because ValidateFile.pm insists the channel-id adheres to
RFC2838 despite the xmltv.dtd only saying "preferably" not "SHOULD".
(Having channel ids of the form "bbc1.bbc.co.uk" will be rejected by
many PVRs since they require the data to match their own list.)
It may also report:
"tv_sort failed on the concatenated data. Probably due to
overlapping data between days."
Both these errors can be ignored.
DISCLAIMER
The Guardian website"s license for these data does not allow non-
personal use.
Certainly any commercial use of listings data obtained by using this
grabber will breach copyright law, but if you are just using the data
for your own personal use then you are probably fine.
By using this grabber you aver you are using the listings data for your
own personal use only and you absolve the author(s) from any liability
under copyright law or otherwise.
AUTHOR
Geoff Westcott. This documentation and parts of the code based on
various other tv_grabbers from the XMLTV-project.
SEE ALSOxmltv(5).
perl v5.20.2 2015-09-15 TV_GRAB_UK_GUARDIAN(1)
