Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
TV_GRAB_UK_TVGUIDE(1) User Contributed Perl DocumentationTV_GRAB_UK_TVGUIDE(1)

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

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

       First you must run tv_grab_uk_tvguide --configure to choose which
       channels	you want to receive.

       Then running tv_grab_uk_tvguide 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_tvguide --help

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 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_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
       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 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).

perl v5.32.0			  2020-08-27		 TV_GRAB_UK_TVGUIDE(1)

NAME | DESCRIPTION | OPTIONS | INSTALLATION | ERROR HANDLING | ENVIRONMENT VARIABLES | SUPPORTED CHANNELS | XMLTV VALIDATION | DISCLAIMER | AUTHOR | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=tv_grab_uk_tvguide&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help