---
name: "tv_grab_fr"
section: "1p"
platform: "linux"
package: "xmltv-util"
version: "1.2.1-1"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/tv_grab_fr"
---

# tv\_grab\_fr(1p)

Grab TV listings for France (Télé Star).

## NAME

tv\_grab\_fr - Grab TV listings for France (Télé Star).

## SYNOPSIS

```
 To configure:
   tv_grab_fr --configure [--config-file FILE] [--gui OPTION]
 To list available channels:
   tv_grab_fr --list-channels
 To grab listings:
   tv_grab_fr [--config-file FILE] [--output FILE]
              [--days N] [--offset N] [--slow]
              [--quiet | --debug]
 To show capabilities:
   tv_grab_fr --capabilities
 To show version:
   tv_grab_fr --version
 To display help:
   tv_grab_fr --help
```

## DESCRIPTION

Output TV listings for many channels available in France (Orange, Free, cable/ADSL/satellite, Canal+ Sat).  The data comes from Télé Star (telestar.fr).  The default is to grab 14 days.

**--configure** Choose which bouquet/channels to grab listings data for.

**--list-channels** List available channels.

**--config-file FILE** Use FILE as config file instead of the default config file. This allows for different config files for different applications.

**--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 (default: 14) starting from today.

**--offset N** Start grabbing N days from today, rather than starting today.

**--slow** Download additional information (e.g. longer description, cast details) for each programme, where available. This option significantly slows down the grabber and is disabled by default.

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

**--debug** Provide additional debugging messages during processing.

**--capabilities** Show which capabilities the grabber supports. For more information, see \<http://wiki.xmltv.org/index.php/XmltvCapabilities\>.

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

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

## SEE ALSO

**xmltv**(5)

## AUTHOR

The current tv\_grab\_fr script was rewritten by Nick Morrott, knowledgejunkie at gmail dot com, to support the new telestar.fr site.