---
name: "tv_grab_pt_vodafone"
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_pt_vodafone"
---

# tv\_grab\_pt\_vodafone(1p)

Grab TV listings for Vodafone in Portugal

## NAME

tv\_grab\_pt\_vodafone - Grab TV listings for Vodafone in Portugal

## SYNOPSIS

tv\_grab\_pt\_vodafone --help

tv\_grab\_pt\_vodafone --configure \[--config-file FILE\]

tv\_grab\_pt\_vodafone \[--config-file FILE\]\
                     \[--days N\] \[--offset N\] \[--channel xmltvid,xmltvid,...\]\
                     \[--output FILE\] \[--quiet \| --debug\]

tv\_grab\_pt\_vodafone --list-channels \[--config-file FILE\]\
                     \[--output FILE\] \[--quiet \| --debug\]

## DESCRIPTION

Output TV listings in XMLTV format for many stations available in Portugal. This program consumes the EPG service from \<https://vodafone.pt/\>.

First you must run **tv\_grab\_pt\_vodafone --configure** to choose which stations you want to receive.

Then running **tv\_grab\_pt\_vodafone** with no arguments will get listings for the stations you chose for the maximum 7 days, including today.

## OPTIONS

**--configure** Prompt for which stations to download and write the configuration file.

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

**--output FILE** When grabbing, write output to FILE rather than standard output.

**--days N** When grabbing, grab N days rather than everything available.

**--offset N** Start grabbing at today + N days.

**--quiet** Only print error-messages on STDERR.

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

**--list-channels** Output a list of all channels that data is available for. The list is in xmltv-format.

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

## ERROR HANDLING

If the grabber fails to download data from Vodafone, it will print an error message to STDERR and then exit with a status code of 1 to indicate that the data is missing.

## ENVIRONMENT VARIABLES

The environment variable HOME can be set to change where configuration files are stored. All configuration is stored in `$HOME`/.xmltv/. On Windows, it might be necessary to set HOME to a path without spaces in it.

## CREDITS

Kevin Groeneveld (kgroeneveld at gmail dot com)

This grabber uses code from tv\_grab\_pt\_meo by Karl Dietz, dekarl -at- users -dot- sourceforge -dot- net, and from tv\_grab\_zz\_sdjson by Kevin Groeneveld, kgroeneveld -at- gmail -dot- com.

The original idea of this grabber came from higuita's shell script, see \<https://github.com/higuita/vodafone.pt-xmltv\>.

Special thanks to Vodafone for building a clean, fast, and public access API; much more reliable than Meo's open API (but sadly not as open) and much better than the lack of any API from NOS.

## AUTHOR

Nuno Sénica, nsenica -at- gmail -dot- com.

## BUGS

None known.