NAME
    tv_grab_uk_rt - Grab TV listings for United Kingdom and Republic of
    Ireland

SYNOPSIS
    tv_grab_uk_rt --help

    tv_grab_uk_rt --configure [--config-file FILE]

    tv_grab_uk_rt [--config-file FILE] [--output FILE] [--days N] [--offset
    N] [--gui OPTION] [--quiet]

    tv_grab_uk_rt --list-channels

    tv_grab_uk_rt --capabilities

    tv_grab_uk_rt --version

DESCRIPTION
    Output TV listings in XMLTV format for many stations available in the
    United Kingdom and Republic of Ireland. The data comes from
    machine-readable files produced by the Radio Times website.

USAGE
    First you must run tv_grab_uk_rt --configure to choose which stations
    you want to receive. Then running tv_grab_uk_rt with no arguments will
    get about a fortnight's listings for the stations you chose.

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

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

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

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

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

    --days N When grabbing, grab N days of data instead of all available.

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

    --list-channels Write output giving <channel> elements for every channel
    available, but no programmes.

    --capabilities Show which capabilities the grabber supports. For more
    information, see <http://xmltv.org/wiki/xmltvcapabilities.html>

    --version Show the version of the grabber.

    --help Print a help message and exit.

    Note that tv_grab_uk_rt always downloads data for all days and then
    filters out the days specified with --days and --offset. It is therefore
    more efficient to omit --days and --offset and use all the returned
    data.

SEE ALSO
    xmltv(5), <http://www.radiotimes.com/>

AUTHOR
    Ed Avis, ed@membled.com

    Nick Morrott, knowledgejunkie@gmail.com (maintainer)

