GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  TV_GRAB_UK_TVGUIDE (1)

.ds Aq ’

NAME

tv_grab_uk_tvguide - Grab TV listings for UK from the TV Guide UK website.

CONTENTS

DESCRIPTION

Output TV listings in XMLTV format for many channels available in UK. The data come from tvguide.co.uk

First you must run <B>tv_grab_uk_tvguide --configureB> to choose which channels you want to receive.

Then running <B>tv_grab_uk_tvguideB> with no arguments will get a listings in XML format for the channels you chose for available days including today.

OPTIONS

Please see <B>tv_grab_uk_tvguide --helpB>

INSTALLATION

The file tv_grab_uk_tvguide.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==74==BBC 1



will change 74 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 doesnt 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_tvguide.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://tvguide.co.uk/

XMLTV VALIDATION

<B>tv_validate_grabberB> 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 TV Guide 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 ALSO

xmltv(5).
Search for    or go to Top of page |  Section 1 |  Main Index


perl v5.20.3 TV_GRAB_UK_TVGUIDE (1) 2016-04-03

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.