tv_grab_il man page

tv_grab_il — Grab TV listings for Israel.


tv_grab_il --help

tv_grab_il --version

tv_grab_il --capabilities

tv_grab_il --description

tv_grab_il [--config-file FILE]
          [--days N] [--offset N] [--slow]
          [--output FILE] [--quiet] [--debug]

tv_grab_il --configure [--config-file FILE]

tv_grab_il --configure-api [--stage NAME]
          [--config-file FILE]
          [--output FILE]

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


Output TV listings in XMLTV format for many channels available in Israel. The data comes from

First you must run tv_grab_il --configure to choose which channels you want to receive.

Then running tv_grab_il with no arguments will get a listings in XML format for the channels you chose for available days including today.


Prompt for which channels to download and write the configuration file.
--config-file FILE
Set the name of the configuration file, the default is ~/.xmltv/tv_grab_il.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 all available days.
--offset N
Start grabbing at today + N days.  N may be negative.
Get programme descriptions as well as title.  (Will take a long time with lots of channels selected.)
Suppress the progress-bar normally shown on standard error.
Provide more information on progress to stderr to help in debugging.
Write output giving <channel> elements for every channel available (ignoring the config file), but no programmes.
Show which capabilities the grabber supports. For more information, see <>
Show the version of the grabber.
Print a help message and exit.

Error Handling

If the grabber fails to download data for some channel on a specific day, it will print an errormessage to STDERR and then continue with the other channels and days. The grabber will exit with a status code of 1 to indicate that the data is incomplete.

Environment Variables

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.

Supported Channels

For information on supported channels, see


lightpriest. This documentation and parts of the code based on various other tv_grabbers from the XMLTV-project.

See Also



2015-06-28 perl v5.26.1 User Contributed Perl Documentation