---
name: "tv_grab_uk_freeview"
section: "1p"
platform: "linux"
package: "xmltv-util"
version: "1.4.0-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/tv_grab_uk_freeview"
---

# tv\_grab\_uk\_freeview(1p)

Grab TV listings for UK (Freeview).

## NAME

tv\_grab\_uk\_freeview - Grab TV listings for UK (Freeview).

## SYNOPSIS

tv\_grab\_uk\_freeview --help

tv\_grab\_uk\_freeview \[--config-file FILE\] --configure \[--gui OPTION\]

tv\_grab\_uk\_freeview \[--config-file FILE\] \[--output FILE\] \[--days N\]\
                     \[--offset N\] \[--fast\] \[--quiet\] \[--debug\]

tv\_grab\_uk\_freeview --list-channels \[--config-file FILE\]\
                     \[--output FILE\] \[--quiet\] \[--debug\]

## DESCRIPTION

Output TV listings for channels available on Freeview (UK).

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

Channel ids will be output either as the Freeview channel number (e.g. 101 for BBC One HD) or as the internal channel id (e.g. 17536 for BBC One HD). You can set this option during --configure.

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

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

**--config-file FILE** Set the name of the configuration file, the default is **~/.xmltv/tv\_grab\_uk\_freeview.conf**.  This is the file written by **--configure** and read when grabbing.

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

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

**--fast** Only fetch summary information for each programme. This is only title, start/stop times, episode number.

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

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

**--debug** Provide more information on progress to standard error to help in debugging.

**--list-channels** Output a list (in xmltv format) of all channels that can be fetched.

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

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

## SEE ALSO

**xmltv**(5).

## AUTHOR

Geoff Westcott, February 2024

## BUGS

None known.