tv_grab_zz_sdjson_sqlite (1)
Leading comments
Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35) Standard preamble: ========================================================================
NAME
tv_grab_zz_sdjson_sqlite - Grab TV and radio program listings from Schedules Direct (subscription required).SYNOPSIS
tv_grab_zz_sdjson_sqlite --helptv_grab_zz_sdjson_sqlite --info
tv_grab_zz_sdjson_sqlite --version
tv_grab_zz_sdjson_sqlite --capabilities
tv_grab_zz_sdjson_sqlite --description
tv_grab_zz_sdjson_sqlite --manage-lineups [--config-file
[--quiet] [--debug] [--passwordhash
tv_grab_zz_sdjson_sqlite [--days N] [--offset N] [--config-file
[--output
[--passwordhash
tv_grab_zz_sdjson_sqlite --configure [--config-file
[--quiet] [--debug]
[--passwordhash
tv_grab_zz_sdjson_sqlite --list-channels [--config-file
[--output
[--passwordhash
tv_grab_zz_sdjson_sqlite --list-lineups [--config-file
[--output
[--passwordhash
tv_grab_zz_sdjson_sqlite --get-lineup [--config-file
[--output
[--passwordhash
DESCRIPTION
OutputThis grabber uses a shared local database which allows for downloading only new/changed/updated information, and in the case of mixed
First, you must run tv_grab_zz_sdjson_sqlite --manage-lineups to manage the lineups available to your grabber configuration at the Schedules Direct service.
Second, you must run tv_grab_zz_sdjson_sqlite --configure to choose which lineup this configuration will grab (this grabber will share the downloaded information for multiple lineups, and can substantially reduce the royal overheads in those cases).
OPTIONS
--manage-lineups Perform Schedules Direct lineup management functions (adding/deleting lineups from your account, and creating the local--configure Prompt for which lineup to download and write the configuration file. Note that one must run --manage-lineups first to create and initialize the database and configure lineups.
--config-file
--output
--download-only Perform a download of the data only (no output).
--no-download Do not download data, but use the existing contents of the local database. Since the code optimizes the data downloaded, this is nominally useful only in offline situations.
--force-download Deletes most existing local database data and forces a download of the data. If there is a suspicion that the data is currupt (and not being automatically corrected), forcing a new download might be necessary.
--days N When grabbing, grab N days rather than all available days.
--offset N Start grabbing at today/now + N days.
--quiet Suppress various informational messages shown on standard error.
--debug Provide more information on progress to stderr to help in debugging. This can get very verbose, but too much data is better that not enough if errors need to be squashed. Note that the debug data may contain information you might prefer to be confidential such as your password hash, so treat the output appropriately.
--passwordhash
--list-channels Write output giving <channel> elements for every channel available in the current configuration.
--list-lineups Write output giving list of available viewing regions. Note that list-lineups is not fully standardized, so the output is subject to change.
--get-lineup Write output giving <channel> elements for every channel available in the current lineup. Note that get-lineup is not fully standardized, so the output is subject to change.
--capabilities Show which capabilities the grabber supports. For more information, see <wiki.xmltv.org/index.php/XmltvCapabilities>
--version Show the version of the grabber.
--help Print a help message and exit.
--info Print a help page and exit.
INSTALLATION
1. First you must signup for an account at Schedules Direct. This is a paid service providing2. Second you need to configure the lineups that you will have access to using your account with this grabber. Run tv_grab_zz_sdjson_sqlite --manage-lineups to add your lineups and to initialize the database.
3. Third, you will need to configure this specific instance of the grabber to select the lineup to use. Run tv_grab_zz_sdjson_sqlite --configure.
4. (Optionally) run tv_grab_zz_sdjson_sqlite --download-only to download and ``fill'' the local database copies of your data. In future runs, only updated information will be downloaded, and the local database will be pruned to delete old/obsolete information.
USAGE
All the normalNote that Schedules Direct only has data for a maximum of about 21 days, (although may be less for some channels) but the accuracy of the data at the end of the period tends to be poor.
ERROR HANDLING
If the grabber encounters a fatal error, it will write a message toENVIRONMENT VARIABLES
The environment variableSUPPORTED CHANNELS
Schedules Direct lineups should support all the channels from your provider orXMLTV VALIDATION
tv_validate_grabber may report an error similar to:
"Line 123 Duplicate channel-tag for 'I12345.json.schedulesdirect.org'"
This is a because at least some providers (typically Cable/Satellite, but sometimes
This error can (should/must?) be ignored.
XMLTV STATIONS vs CHANNELS
This also results in a failing of the configuration capability which treats the selecting of content as being station based, which is not always the same thing as a <channel> (for example, for Cable providers, a ``station'' may be transmitted on many ``channels'' (perhaps in different resolutions), but an individual may only be authorized to receive some of the ``channels''). One may want the ``station'' schedules and programs, but not to see the ``channel'' returned because they cannot tune it.
CHANNEL SELECTION
Due to theFAQs
No FAQs yet....DISCLAIMER
The Schedules Direct service requires a subscription, and only allows for usage for personal use with approved open source projects. Refer to the Schedules Direct site for their requirements and how to sign up.AUTHOR
Gary Buhrmaster. As with most tv_grabbers, documentation, ideas, and parts of the code may have been leveraged from other existing grabbers from the XMLTV-project. We stand on the shoulders of those that came before us.COPYRIGHT
Copyright (c) 2016 Gary Buhrmaster <gary.buhrmaster@gmail.com>This code is distributed under the
This program is free software; you can redistribute it and/or modify it under the terms of the
This program is distributed in the hope that it will be useful, but
You should have received a copy of the