SYNOPSIS

tv_grab_pt_meo --help

tv_grab_pt_meo --configure [--config-file \s-1FILE\s0] [--root-url \s-1URL\s0]

tv_grab_pt_meo [--config-file \s-1FILE\s0] [--root-url \s-1URL\s0]

                 [--days N] [--offset N] [--channel xmltvid,xmltvid,...]
                 [--output \s-1FILE\s0] [--quiet] [--debug]

tv_grab_pt_meo --list-channels [--config-file \s-1FILE\s0] [--root-url \s-1URL\s0]

                 [--output \s-1FILE\s0] [--quiet] [--debug]

DESCRIPTION

Output \s-1TV\s0 and listings in \s-1XMLTV\s0 format for many stations available in Portugal. This program consumes the \s-1EPG\s0 service offering from \s-1SAPO\s0 at <http://services.sapo.pt/Metadata/Service/EPG?culture=EN>. See <http://seguranca.sapo.pt/termosdeutilizacao/apis_rss_webservices.html> for their terms of service. (automatic translation suggests it's free for personal use, verfication appreciated)

First you must run tv_grab_pt_meo --configure to choose which stations you want to receive.

Then running tv_grab_pt_meo with no arguments will get a listings for the stations you chose for all available days including today.

OPTIONS

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

--config-file \s-1FILE\s0 Set the name of the configuration file, the default is ~/.xmltv/tv_grab_pt_meo.conf. This is the file written by --configure and read when grabbing.

--output \s-1FILE\s0 When grabbing, write output to \s-1FILE\s0 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 \s-1STDERR\s0.

--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 webstep, it will print an errormessage to \s-1STDERR\s0 and then exit with a status code of 1 to indicate that the data is missing.

ENVIRONMENT VARIABLES

The environment variable \s-1HOME\s0 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 \s-1HOME\s0 to a path without spaces in it.

CREDITS

Grabber written by Karl Dietz, dekarl -at- users -dot- sourceforge -dot- net as a test of the documentation on grabber writing. This documentation copied from tv_grab_cz by Mattias Holmlund, This documentation copied from tv_grab_uk by Ed Avis, ed -at- membled -dot- com. Original grabber by Jiri Kaderavek, jiri -dot- kaderavek -at- webstep -dot- net with modifications by Petr Stehlik, pstehlik -at- sophics -dot- cz.

Data provided via web service from \s-1SAPO\s0 accompanying their \s-1MEO\s0 \s-1TV\s0 service. Check their terms of usage!

BUGS

None known.