SYNOPSIS

tv_grab_na_dtv --help

tv_grab_na_dtv --configure [--config-file \s-1FILE\s0] [--root-url \s-1URL\s0]

tv_grab_na_dtv [--config-file \s-1FILE\s0] [--root-url \s-1URL\s0]

                 [--days N] [--offset N] [--channel xmltvid,xmltvid,...]
                 [--output \s-1FILE\s0] [--quiet] [--debug]

tv_grab_na_dtv --list-channels [--config-file \s-1FILE\s0] [--root-url \s-1URL\s0]

                 [--output \s-1FILE\s0] [--quiet] [--debug]

DESCRIPTION

Output \s-1TV\s0 and listings in \s-1XMLTV\s0 format from directv.com.

First you must run tv_grab_na_dtv --configure to choose which stations you want to receive.

Then running tv_grab_na_dtv with no arguments will get listings for the stations you chose for five days including today.

OPTIONS

--configure Prompt for which stations to download and write the configuration file.

--config-file \s-1FILE\s0 Set the name of the configuration file, the default is ~/.xmltv/tv_grab_na_dtv.conf. This is the file written by --configure and read when grabbing.

--output \s-1FILE\s0 When grabbing, write output to \s-1FILE\s0 rather than standard output.

--days N When grabbing, grab N days rather than 5.

--offset N Start grabbing at today + N days.

--quiet Only print error-messages on \s-1STDERR\s0.

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

--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 error message to \s-1STDERR\s0 and then exit with a status code of 1 to indicate that the data is missing.

ENVIRONMENT VARIABLES

The environment variable \s-1HOME\s0 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 \s-1HOME\s0 to a path without spaces in it.

\s-1TEMP\s0 or \s-1TMP\s0, if present, will override the directory used to contain temporary files. Default is \*(L"/tmp\*(R", so under Windows one of these is required.

CREDITS

Grabber written Rod Roark (http://www.sunsetsystems.com/), modified by Adam Lewandowski ([email protected]) in January 2011 to account for DirecTV site changes.

BUGS

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.