Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  TV_GRAB_NA_DTV (1)

.ds Aq ’


tv_grab_na_dtv - Grab TV listings from DirecTV.



tv_grab_na_dtv --help

tv_grab_na_dtv --configure [--config-file FILE]

tv_grab_na_dtv [--config-file FILE]
[--days N] [--offset N] [--processes N]
[--output FILE] [--quiet] [--debug]

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


Output TV and listings in XMLTV format from

First you must run <B>tv_grab_na_dtv --configureB> to choose which stations you want to receive.

Then running <B>tv_grab_na_dtvB> with no arguments will get listings for the stations you chose for five days including today.


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

<B>--config-file FILEB> Set the name of the configuration file, the default is <B>~/.xmltv/tv_grab_na_dtv.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 5.

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

<B>--processes NB> Nunber of processes to run to fetch program details. 8 is a good number to try. You could try more with plenty of CPU and bandwidth. More processes will reduce the time it takes to fetch your listings. But be warned, the benefit might not be as much as you think, and the more processes you initiate the more you are making it obvious you are scraping and more likely to get banned by the source site. A ’fast’ website scraper is an oxymoron!

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

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

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


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


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.

TEMP or TMP, if present, will override the directory used to contain temporary files. Default is /tmp, so under Windows one of these is required.


Grabber written Rod Roark (, Modified by Adam Lewandowski ( (January 2011, October 2014)
to account for DirecTV site/API changes.


Like any screen-scraping grabber, this one will break regularly as the web site changes, and you should try to fetch a new one from the project’s repository. At some point the breakage might not be fixable or it may be that nobody wants to fix it. Sane people should use Schedules Direct instead.
Search for    or go to Top of page |  Section 1 |  Main Index

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

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