tv_grab_it_dvb(1) Grab TV listings for Italy from the DVB-S stream


tv_grab_it_dvb --help

tv_grab_it_dvb [--adapter N] [--config-file FILE] --configure

tv_grab_it_dvb [--config-file FILE] [--output FILE] [--days N]
               [--offset N] [--quiet] [--verbose] [--adapter N]


 Output TV listings for several channels as provided by the DVB-S stream from Skyitalia.
 This grabber is based on the work of Lukkinosat for everything concerning the decoding of data.
 The tuning part is mostly a port to perl of the relevant parts in szap.
 This is an early release and should be considered beta quality.

First run tv_grab_it_dvb --configure to choose which channels you want to download. Then running tv_grab_it with no arguments will output listings in XML format to standard output.

--configure Prompt for which channels, and writes the configuration file.

--adapter Use this adapter for tuning and grabbing. Default is 0.

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

--gui OPTION Use this option to enable a graphical interface to be used. OPTION may be 'Tk', or left blank for the best available choice. Additional allowed values of OPTION are 'Term' for normal terminal output (default) and 'TermNoProgressBar' to disable the use of XMLTV::ProgressBar.

--output FILE write to FILE rather than standard output.

--days N Grab N days. Since we cannot decide how much data we get we simply throw away everyting above this number of days.

--offset N Start N days in the future. The default is to start from today.

--quiet Suppress the progress messages normally written to standard error.

--no-cache-summaries Disables caching of summaries in the file summaries.cache It is advised to leave this option on as the summaries part of the data stream can be very different between grabs, and you might get blank descriptions.

--verbose Prints out verbose information useful for debugging. Repeat (up to 4x) for more verbosiness

--min-noname This is a hack. As I have a situation where there are a few channels whose name I cannot find (usually 3 or 4) you can sat the number of channel that can be left nameless. Try using this if the grabber keep on running forever.

--version Show the version of the grabber.

--help Print a help message and exit.


This grabber relies on the linux dvb api, and therefore does not run under other operating systems.

For Debian users: this means the package does not depend on the Linux::DVB perl package, as this would make it uninstallable on the Debian kFreeBSD and HURD ports. Please install the liblinux-dvb-perl package to use this grabber.


tv_grab_it_dvb --adapter 2 --configure
configures tv_grab_it_dvb using adapter number 2
tv_grab_it_dvb --adapter 2 --quiet
grabs the full data without displaying anything (useful in cron scripts)


Davide Chiarini, [email protected]

you can find some more help at