---
name: "stationlist.xml"
section: "5"
platform: "linux"
package: "tvtime"
version: "1.0.11-7"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/stationlist.xml"
---

# stationlist.xml(5)

tvtime station configuration file

## 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/1.md), [**tvtime-command**(1)](/tvtime-command/1.md), [**tvtime-scanner**(1)](/tvtime-scanner/1.md), [*tvtime.xml*(5)](/tvtime.xml/5.md).