Provided by: tvtime_1.0.2-6.1ubuntu1_i386 bug

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