XMLTV is an XML format for television channel and programme listing information. It can describe channel names and identifiers, programme titles, start times and optional details such as descriptions, categories or episode information. It is schedule metadata, not a video-stream format or a guarantee that a listed programme can be watched. A player needs to retrieve and parse the data, associate it with playable channels and interpret its times correctly. The available detail and time coverage depend on the feed, and applications may display only part of the supplied metadata.
XMLTV and Playlist
A playlist identifies playable items; XMLTV supplies schedule information about channels and programmes.
Channels and programmes are linked
Channel records define identities and display information. Programme records refer to a channel identity and carry timing and programme details. A feed can therefore contain correctly formed schedules that a player cannot attach to its playlist because the identifiers differ. Conversely, channel names may import while no relevant programme records cover the period the viewer is trying to browse.
XML validity is only one check
Well-formed XML establishes that the document has valid basic structure, not that every schedule is accurate or every channel mapping exists. Escaping errors can prevent parsing, while logically wrong identifiers or timestamps can survive parsing. Compressed delivery, authentication and response handling add retrieval considerations outside the XML itself. Inspect what the source actually returned rather than assuming the URL always supplies usable listing data.
Review a small complete relationship
For an empty guide, check one channel record and one programme that should be current. Verify the shared identifier, start time, any end time and timezone information. Then confirm the player’s mapping and displayed local time. Large feeds can hide a simple mismatch, so a focused sample often clarifies whether the failure concerns delivery, parsing, identity or date coverage.
An illustrative example
An XMLTV feed downloads and parses successfully, but its programme records use IDs absent from the player’s channel mappings. The guide stays blank even though the file contains titles and times. Correcting that relationship can populate the guide; changing the video decoder would have no effect on schedule metadata.
Practical actions
- Inspect one channel and its referenced programme records.
- Check date coverage as well as XML parsing.
- Separate feed retrieval, mapping and timezone interpretation.