1stationlist.xml(5)            File Formats Manual           stationlist.xml(5)
2
3
4

NAME

6       stationlist.xml - tvtime station configuration file
7
8

SYNOPSIS

10       ~/.tvtime/stationlist.xml
11
12

DESCRIPTION

14       The stationlist.xml file contains the configuration of channel informa‐
15       tion for capture cards with tuners.  It contains a list of active chan‐
16       nels along with their frequencies, renumbering information, and channel
17       name.  The stationlist.xml file is updated  by  tvtime  at  runtime  to
18       store  settings  across sessions.  For this reason, you should not edit
19       this file while tvtime is running, as your changes may be overwritten.
20
21       This file is created or updated whenever channel information is changed
22       in  tvtime.  This is done when renumbering a channel, using the channel
23       scanner, or manually activating or deactivating a specific channel from
24       the list.
25
26       Channel settings are saved specific to norm and frequency table.
27
28           <?xml version="1.0"?>
29           <!DOCTYPE stationlist PUBLIC "-//tvtime//DTD stationlist 1.0//EN"
30             "http://tvtime.sourceforge.net/DTD/stationlist.dtd">
31           <stationlist xmlns="http://tvtime.sourceforge.net/DTD/">
32             <list norm="NTSC" frequencies="US-Cable">
33               <station ... />
34               ... station list
35             </list>
36           </stationlist>
37
38       That  is,  each  norm/frequency combination will get its own section in
39       the configuration file.  The frequencies name is not special,  you  can
40       have frequencies="foobar" and running
41       will  do the right thing.  The norm, however, must match the norm being
42       used.
43
44       Entries in a list are in the following form:
45
46           <station name="CNN" active="1" position="18"
47                    band="US Cable" channel="18"/>
48           <station name="DSF" active="1" position="12"
49                    band="VHF E2-E12" channel="E12"/>
50
51
52

STATIONS

54       Each station has its own properties that should be set.
55
56
57       name   The human-readable name of the current station.
58
59
60       active When set to 1, the channel is active.  To deactivate  the  chan‐
61              nel, set this value to 0.
62
63
64       position
65              This  setting specifies the position the channel occupies on the
66              dial.  This allows users to arbitrarily map any particular chan‐
67              nel to a particular position on the dial.
68
69
70       band
71       channel
72
73              The possible bands and channels available in tvtime are:
74
75
76              Band name          Channels provided
77              US Cable           1–99
78              US Cable 100       100–125
79              US Two-Way         T7, T8, T9, T10, T11, T12 T13, T14
80              US Broadcast       2–83
81              China Broadcast    1–68, A1–A7, B1–B31, C1–C5
82              Japan Broadcast    1–62
83              Japan Cable        13–63
84              VHF E2-E12         E1–E12
85              VHF S1-S41         S1–S41
86              VHF Misc           X, Y, Z, Z+1, Z+2
87              VHF France         K01–K10, KB–KQ, H01–H19
88              VHF Russia         R1–R12, SR1–SR19
89              VHF Australia      AS1–AS12, AS5A, AS9A
90              VHF Italy          A–H, H1, H2
91              VHF Ireland        I1–I9
92              VHF South Africa   1–13
93              UHF                U21–U69
94              UHF Australia      AU28–AU69
95              Australia Optus    01–058
96
97              Custom  channels can be included manually by specifying the fre‐
98              quency in megahertz:
99
100                  <station name="2" active="1" position="0"
101                           band="Custom" channel="55.69MHz"/>
102
103
104       norm   A per-channel norm can be specified in the stationlist.  This is
105              for  stations  which  receive  both PAL and SECAM stations, such
106              that they can choose the  colour  encoding  format  per-channel.
107              The only valid values here are either PAL or SECAM.
108
109
110       network
111              Sets  the  name  of  the  network  for the OSD display.  In NTSC
112              regions, this is set from the XDS information in the VBI if  VBI
113              decoding is enabled.
114
115
116       call   Sets  the  call  letters of the network for the OSD display.  In
117              NTSC regions, this is set from the XDS information in the VBI if
118              VBI decoding is enabled.
119
120
121       xmltvid
122              Sets the XMLTV channel identifier to associate this channel with
123              if tvtime cannot automatically make the association.   For  fol‐
124              lowing channel definition in an XMLTV file:
125
126                <channel id="I10119.labs.zap2it.com">
127                  <display-name>CICA</display-name>
128                  <display-name>TV Ontario (CICA)</display-name>
129                  <display-name>Canadian Independent</display-name>
130                </channel>
131
132              An associated stationlist entry would be:
133
134                  <station name="2" active="1" position="0"
135                           band="Custom" channel="55.69MHz"
136                           xmltvid="I10119.labs.zap2it.com"/>
137
138

AUTHORS

140       Achim Schneider, Billy Biggs.
141
142

SEE ALSO

144       tvtime(1), tvtime-command(1), tvtime-scanner(1), tvtime.xml(5).
145
146
147
148tvtime 1.0RC1                    October 2004               stationlist.xml(5)