tv_grab_br_net.1p

Langue: en

Version: 2008-07-23 (ubuntu - 07/07/09)

Section: 1 (Commandes utilisateur)

NAME

tv_grab_br_net - Grab TV listings for Brazil's NET Cable service (from nettv.globo.com).

SYNOPSIS

tv_grab_br_net --help

tv_grab_br_net --configure [--config-file FILE] [--gui OPTION]

tv_grab_br_net [--config-file FILE] [--output FILE] [--gui OPTION]
               [--days N] [--offset N] [--quiet]
               [--relax N] [--slow] [--fast]

tv_grab_br_net --list-channels [--config-file FILE]
               [--output FILE] [--quiet]

DESCRIPTION

Output TV listings for several channels available in Brazil from the widely present NET cable provider. The data comes from nettv.globo.com which is their web page containing program information. The grabber relies on parsing HTML so it might stop working at any time.

First run tv_grab_br_net --configure to choose your city, your lineup and which channels you want to download. Should your city not be listed even though NET has it on their homepage...sorry, they are using 2 different formats. Only one is implemented here. Please see KNOWN PROBLEMS.

Then running tv_grab_br_net with no arguments will output listings in XML format to standard output.

OPTIONS

--configure Ask for configuration-data, which channels to download and write the configuration file.

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

--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. The default is five.

--offset N Start N days in the future. The default is to start from today (=zero). Set to -1 to grab data beginning yesterday.

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

--list-channels Write output giving <channel> elements for every channel available (using the city and selection from the config file), but no programs. All channels are listed. Even those without any information about broadcasts.

--slow Overrides the default set by the configuration. It enables the long strategy run: There is only basic information listed on the main channel page. However there is a lot more provided on subsequent pages for particular broadcasts. If you'd like to parse the data from these pages as well, set it in the configuration or supply this flag. But consider that the grab process takes much much longer when doing so, since many more web pages have to be retrieved. Please note that this option is a non-standard extension to the XMLTV-options and should be specified at configuration-time.

--fast Overrides the default set by the configuration. It switches back to fast operation if the configuration specified slow. Please note that this option is a non-standard extension to the XMLTV-options and should be specified at configuration-time.

--relax N May be used if time is not an issue, bandwidth is limited or you don't want to pound the NET Website (good idea). It adds a sleep after fetching each page. The number of seconds paused is random and between 1 and N. Since this also is a non-standard extension, you should consider setting it in the configuration. The commandline-option is only meant to override the config.

--version Show the version of the grabber.

--help Print a help message and exit.

TODO

- translate user-interface and documentation to Portuguese
- use existing XML and gather more details by using the URL of the broadcasts
- logos/images (impossible because not implemented by the NET website)
- further preparation for new features in XMLTV 0.6

KNOWN PROBLEMS

For some channels it seems NET has no data available whatsoever.

[ Removed 2008-07-22: When grabbing data for ``today'' or ``tomorrow'' these channels will automatically be commented out in the used configuration-file. This should not disturb any functionality unless you're keen for ``empty'' channels. To add back in set $auto_update_conf to 1.]

The NET website is sometimes inconsistent and buggy. And while the grabber might work perfect for some cities, it might not even be configurable for others. This is due to the bundles/selections they offer for the particular cities. It looks like for some cities the site works completely different :-(

SEE ALSO

xmltv(5).

AUTHOR

Max Becker, maxbecker -at- rocketmail -dot- com. Based on various other tv_grabbers from the XMLTV-project. Initial inspiration by Cristiano Garcia.

BUGS

If you happen to find a bug, please send me an email or mail to one of the XMLTV mailing lists, see web pages at http://sourceforge.net/projects/xmltv/. Copyright X 2005-2008 Max Becker.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.