tv_grab_na_tvmedia man page

tv_grab_na_tvmedia — Grab TV listings for North America.

Synopsis

tv_grab_na_tvmedia --help

tv_grab_na_tvmedia --configure [--config-file FILE]

tv_grab_na_tvmedia [--config-file FILE]
[--days N] [--offset N]
[--output FILE] [--quiet]

tv_grab_na_tvmedia --list-channels [--config-file FILE]
[--output FILE] [--quiet]

Description

Outputs TV listings in XMLTV format for stations available in North America. Data is provided by TVMedia Inc.

The grabber requires an _active_ subscription to XMLTVListings.com, as well as at least one lineup selected from your account page. Then you can run tv_grab_na_tvmedia --configure to set your API key and which lineup you want to receive.

Then running tv_grab_na_tvmedia with no arguments will get listings for all the channels you in your lineup, as you configured on XMLTVListings.com

Options

--configure
Prompt for which stations to download and write the configuration file.
--config-file FILE
Set the name of the configuration file, the default is ~/.xmltv/tv_grab_na_tvmedia.conf. This is the file written by --configure and read when grabbing.
--output FILE
When grabbing, write output to FILE rather than standard output.
--days N
When grabbing, grab N days rather than 5.
--offset N
Start grabbing at today + N days. Also supports negative offset for past listings.
--quiet
Only print error-messages on STDERR.
--debug
Provide more information on progress to stderr to help in debugging.
--list-channels Output a list of all channels that data is available
for. The list is in xmltv-format.
--capabilities
Show which capabilities the grabber supports. For more information, see <http://wiki.xmltv.org/index.php/XmltvCa…>
--version
Show the version of the grabber.
--help
Print a help message and exit.

Error Handling

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

Credits

Grabber written by Matthew April on behalf of TVMedia.ca This documentation copied from tv_grab_cz, This code modified from tv_grab_cz, by Mattias Holmlund, mattias -at- holmlund -dot- se.

Bugs

None known.

Info

2015-06-27 perl v5.24.0 User Contributed Perl Documentation