NAME

       stationlist.xml - tvtime station configuration file

SYNOPSIS

       ~/.tvtime/stationlist.xml

DESCRIPTION

       The  stationlist.xml  file  contains  the configuration of channel information for capture
       cards with tuners.  It contains a list of active channels along  with  their  frequencies,
       renumbering  information, and channel name.  The stationlist.xml file is updated by tvtime
       at runtime to store settings across sessions.  For this reason, you should not  edit  this
       file while tvtime is running, as your changes may be overwritten.

       This  file  is created or updated whenever channel information is changed in tvtime.  This
       is done when renumbering a channel, using the channel scanner, or manually  activating  or
       deactivating a specific channel from the list.

       Channel settings are saved specific to norm and frequency table.

           <?xml version="1.0"?>
           <!DOCTYPE stationlist PUBLIC "-//tvtime//DTD stationlist 1.0//EN"
             "http://tvtime.sourceforge.net/DTD/stationlist.dtd">
           <stationlist xmlns="http://tvtime.sourceforge.net/DTD/">
             <list norm="NTSC" frequencies="US-Cable">
               <station ... />
               ... station list
             </list>
           </stationlist>

       That  is,  each  norm/frequency  combination will get its own section in the configuration
       file.  The frequencies name is not special, you can have frequencies="foobar" and running
           tvtime -f foobar
       will do the right thing.  The norm, however, must match the norm being used.

       Entries in a list are in the following form:

           <station name="CNN" active="1" position="18"
                    band="US Cable" channel="18"/>
           <station name="DSF" active="1" position="12"
                    band="VHF E2-E12" channel="E12"/>

STATIONS

       Each station has its own properties that should be set.

       name   The human-readable name of the current station.

       active When set to 1, the channel is active.  To deactivate the channel, set this value to
              0.

       position
              This  setting specifies the position the channel occupies on the dial.  This allows
              users to arbitrarily map any particular channel to a  particular  position  on  the
              dial.

       band
       channel

              The possible bands and channels available in tvtime are:

              Band name          Channels provided
              US Cable           1–99
              US Cable 100       100–125
              US Two-Way         T7, T8, T9, T10, T11, T12 T13, T14
              US Broadcast       2–83
              China Broadcast    1–68, A1–A7, B1–B31, C1–C5
              Japan Broadcast    1–62
              Japan Cable        13–63
              VHF E2-E12         E1–E12
              VHF S1-S41         S1–S41
              VHF Misc           X, Y, Z, Z+1, Z+2
              VHF France         K01–K10, KB–KQ, H01–H19
              VHF Russia         R1–R12, SR1–SR19
              VHF Australia      AS1–AS12, AS5A, AS9A
              VHF Italy          A–H, H1, H2
              VHF Ireland        I1–I9
              VHF South Africa   1–13
              UHF                U21–U69
              UHF Australia      AU28–AU69
              Australia Optus    01–058

              Custom channels can be included manually by specifying the frequency in megahertz:

                  <station name="2" active="1" position="0"
                           band="Custom" channel="55.69MHz"/>

       norm   A per-channel norm can be specified in the stationlist.  This is for stations which
              receive both PAL and SECAM stations, such that they can choose the colour  encoding
              format per-channel.  The only valid values here are either PAL or SECAM.

       network
              Sets  the  name  of  the network for the OSD display.  In NTSC regions, this is set
              from the XDS information in the VBI if VBI decoding is enabled.

       call   Sets the call letters of the network for the OSD display.  In NTSC regions, this is
              set from the XDS information in the VBI if VBI decoding is enabled.

       xmltvid
              Sets  the  XMLTV channel identifier to associate this channel with if tvtime cannot
              automatically make the association.  For following channel definition in  an  XMLTV
              file:

                <channel id="I10119.labs.zap2it.com">
                  <display-name>CICA</display-name>
                  <display-name>TV Ontario (CICA)</display-name>
                  <display-name>Canadian Independent</display-name>
                </channel>

              An associated stationlist entry would be:

                  <station name="2" active="1" position="0"
                           band="Custom" channel="55.69MHz"
                           xmltvid="I10119.labs.zap2it.com"/>

AUTHORS

       Achim Schneider, Billy Biggs.

SEE ALSO

       tvtime(1), tvtime-command(1), tvtime-scanner(1), tvtime.xml(5).