---
name: "tv_grab_de_tvtoday"
section: "1p"
platform: "linux"
package: "xmltv-util"
version: "0.5.44-1.1"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/tv_grab_de_tvtoday"
---

# tv\_grab\_de\_tvtoday(1p)

Grab TV listings for Germany (from www.tvtoday.de webpage).

## NAME

tv\_grab\_de\_tvtoday - Grab TV listings for Germany (from www.tvtoday.de webpage).

## SYNOPSIS

tv\_grab\_de\_tvtoday --help

tv\_grab\_de\_tvtoday \[--config-file FILE\] --configure \[--gui OPTION\]

tv\_grab\_de\_tvtoday \[--config-file FILE\] \[--output FILE\] \
                    \[--days N\] \[--offset N\]\
                    \[--quiet\] \[--slow\] \[--nosqueezeout\]

tv\_grab\_de\_tvtoday --list-channels \[--icons\]

tv\_grab\_de\_tvtoday --capabilities

tv\_grab\_de\_tvtoday --version

## DESCRIPTION

Output TV listings for several channels available in Germany. The data comes from www.tvtoday.de which is the webpage of one of  the most popular TV magazines in Germany. The grabber relies on parsing HTML so it might stop working at any time.

First run **tv\_grab\_de\_tvtoday --configure** to choose, which channels  you want to download. Then running **tv\_grab\_de\_tvtoday** with no  arguments will output listings in XML format to standard output.

**--configure** Ask for each available channel whether to download and write the configuration file.

**--config-file FILE** Set the name of the configuration file, the default is **~/.xmltv/tv\_grab\_de\_tvtoday.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 Term::ProgressBar.

**--output FILE** Write to FILE rather than standard output.

**--days N** Grab N days.  The default is seven.

**--offset N** Start N days in the future.  The default is to start from today (= zero). Set to -1 to grab data beginning yesterday.

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

**--slow** enables long strategy run: tvtoday.de publishes only some (vital) information on the actual listing pages, the rest is shown in a separate popup window. If you'd like to parse the data from these popups as well, supply this flag. But consider that the grab process takes much longer when doing so, since many more web pages have to be retrieved.

**--nosqueezeout** Disables aggressive squeeze out of information field from the index pages. If specified, the program description from tvtoday.de is passed trough as data of the desc-tag, otherwise the data is parsed for information about actors, director, etc. and understood data gets returned in it's corresponding field.

**--list-channels** Write output giving \<channel\> elements for every channel available (ignoring the config file), but no programmes.

**--icons** Get the URL for channel-logos together with the channel-list. Mind that this takes a long time, since a webpage has to be requested for every channel.

**--capabilities** Show which capabilities the grabber supports. For more information, see \<http://membled.com/twiki/bin/view/Main/XmltvCapabilities\>

**--version** Show the version of the grabber.

**--help** Print a help message and exit.

## SEE ALSO

*xmltv*(5).

## AUTHOR

Stefan Siegl, stesie@brokenpipe.de. Inspired by tv\_grab\_fi by Matti Airas.

## BUGS

If you happen to find a bug, you're requested to send a mail to me at **stesie@brokenpipe.de** or to one of the XMLTV mailing lists, see webpages at http://sourceforge.net/projects/xmltv/.