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