NAME
    tv_grab_uk_rt - Grab TV listings for Britain and Ireland

SYNOPSIS
    tv_grab_uk_rt --help

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

    tv_grab_uk_rt [--config-file FILE] [--output FILE] [--quiet] [--days N]
    [--offset N] [--list-channels]

DESCRIPTION
    Output TV and radio listings in XMLTV format for many stations available
    in the United Kingdom and Republic of Ireland. The data comes from a
    machine-readable file 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 List channels.

    --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.beeb.com/>

AUTHOR
    Ed Avis, ed@membled.com

