tv_grab_pt_vodafone - Grab TV listings for Vodafone in Portugal
Contents
Bugs
None known.
perl v5.40.1 2025-04-19 TV_GRAB_PT_VODAFONE(1p)
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.
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.
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.
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.
Name
tv_grab_pt_vodafone - Grab TV listings for Vodafone in Portugal
Options
--configure Prompt for which stations to download and write the configuration file.
--config-fileFILE 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.
--outputFILE When grabbing, write output to FILE rather than standard output.
--daysN When grabbing, grab N days rather than everything available.
--offsetN 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.
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]
