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_FR_KAZER (1)

.ds Aq ’

NAME

tv_grab_fr_kazer - Grab TV listings from Kazer in France.

CONTENTS

SYNOPSIS

tv_grab_fr_kazer --help

tv_grab_fr_kazer --configure [--config-file FILE]

tv_grab_fr_kazer [--config-file FILE]
[--days N] [--offset N] [--channel xmltvid,xmltvid,...]
[--output FILE] [--quiet] [--debug]

tv_grab_fr_kazer --list-channels [--config-file FILE]
[--output FILE] [--quiet] [--debug]

DESCRIPTION

Output TV and listings in XMLTV format for many stations available in France. This program consumes the EPG service offering from Kazer at <http://www.kazer.org/>. See TODO INSERTLINKHERE for their terms of service. (automatic translation suggests it’s free for personal use, verfication appreciated)

First you must register an account at kazer.org and choose which stations you want to receive.

Then run <B>tv_grab_fr_kazer --configureB> 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)

After these two steps running <B>tv_grab_fr_kazerB> with no arguments will get a listings for the stations you chose for all available days including today.

ATTENTION: 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=<your userhash>.

OPTIONS

<B>--configureB> Prompt for which stations to download and write the configuration file.

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.

<B>--config-file FILEB> Set the name of the configuration file, the default is <B>~/.xmltv/tv_grab_fr_kazer.confB>. This is the file written by <B>--configureB> and read when grabbing.

<B>--output FILEB> When grabbing, write output to FILE rather than standard output.

<B>--days NB> When grabbing, grab N days rather than everything available.

<B>--offset NB> Start grabbing at today + N days.

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.

<B>--quietB> Only print error-messages on STDERR.

<B>--debugB> Provide more information on progress to stderr to help in debugging.

<B>--list-channelsB> Output a list of all channels that data is available
for. The list is in xmltv-format.

<B>--capabilitiesB> Show which capabilities the grabber supports. For more information, see <http://wiki.xmltv.org/index.php/XmltvCapabilities>

<B>--versionB> Show the version of the grabber.

<B>--helpB> Print a help message and exit.

ERROR HANDLING

If the grabber fails to download data from kazer.org, it will print an errormessage to STDERR and then exit with a status code of 1 to indicate that the data is missing.

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.

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.

Data provided via web service from kazer.org. Check their terms of usage!

BUGS

None known.
Search for    or go to Top of page |  Section 1 |  Main Index


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

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