tv_grab_na_tvmedia - Grab TV listings for North America.
Contents
Bugs
None known.
perl v5.40.1 2025-04-19 TV_GRAB_NA_TVMEDIA(1p)
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.
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
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.
Name
tv_grab_na_tvmedia - Grab TV listings for North America.
Options
--configure Prompt for which stations to download and write the configuration file.
--config-fileFILE 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.
--outputFILE When grabbing, write output to FILE rather than standard output.
--daysN When grabbing, grab N days rather than 5.
--offsetN 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/XmltvCapabilities>
--version Show the version of the grabber.
--help Print a help message and exit.
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]
