aboutsummaryrefslogtreecommitdiffstats
path: root/docs/man/en/stationlist.xml.5
blob: 90e21226cb53de2370d27d1a543139cd5c2bf827 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
.\" Man page for stationlist.xml
.\" Copyright (c) 2003, 2004  Billy Biggs
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or (at
.\" your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
.\" General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
.\"
.TH stationlist.xml 5 "October 2004" "tvtime 1.0RC1"

.SH NAME
stationlist.xml \- tvtime station configuration file

.SH SYNOPSIS

.I ~/.tvtime/stationlist.xml

.SH DESCRIPTION

The
.I 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 
.I stationlist.xml
file is updated by
.B tvtime
at runtime to store settings across sessions.  For this reason, you 
should not edit this file while
.B tvtime
is running, as your changes may be overwritten.

This file is created or updated whenever channel information is changed
in
.BR 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
.br
.h'4n'tvtime -f foobar
.br
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"/>


.SH STATIONS

Each station has its own properties that should be set.

.TP
.B name
The human-readable name of the current station.

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

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

.TP
.PD 0
.B band
.TP
.B channel

The possible bands and channels available in
.B tvtime
are:
.PD

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

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

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

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

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

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

.TP
.B 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"/>

.SH AUTHORS

Achim Schneider,
Billy Biggs.

.SH "SEE ALSO"

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

Privacy Policy