--- name: "tv_grab_za" section: "1p" platform: "linux" package: "xmltv-util" version: "0.5.63-2" release: "Debian 8 (Jessie)" platforms: ["linux"] url: "https://new.carta.tech/tv_grab_za" --- # tv\_grab\_za(1p) Grab TV listings for South Africa. ## NAME tv\_grab\_za - Grab TV listings for South Africa. ## SYNOPSIS tv\_grab\_za --help tv\_grab\_za \[--config-file FILE\] --configure \[--gui OPTION\] tv\_grab\_za \[--config-file FILE\] \[--output FILE\] \[--days N\]\ \[--quiet\] \[--retries N\] ## DESCRIPTION Output TV listings for DSTV channels available in South Africa. The data comes from www.dstv.com. The grabber relies on parsing HTML so it might stop working at any time. First run **tv\_grab\_za --configure** to choose, which channels you want to download. Then running **tv\_grab\_za** with no arguments will output listings in XML format to standard output. **--configure** Prompt for which channels, and write the configuration file. **--config-file FILE** Set the name of the configuration file, the default is **~/.xmltv/tv\_grab\_za.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. Can be 1, 7, 14 or 30. Default is 14 **--quiet** suppress the progress messages normally written to standard error. **--retries** number of retries before failing channel download. **--help** print a help message and exit. ## SEE ALSO *xmltv*(5). ## AUTHORS Chris Picton \ Neil Garratt \ Based on tv\_grab\_fi by Matti Airas. Latest version always available at http://xmltv.cvs.sourceforge.net/xmltv/xmltv/grab/za/ ## BUGS Does not automatically update itself, when DSTV changes their site