The tvg-id attribute commonly links an M3U channel entry to a channel identifier in an XMLTV guide. The identifier is a matching key, not necessarily the name viewers recognize. If the keys differ, a channel can play normally while its programme guide remains empty or shows another station.
Compare identifiers before renaming channels
Look for the channel id in the XMLTV source and the tvg-id in the playlist entry. A display name can vary between the two files without being the actual matching key. Automatic name matching is a player convenience, not a reliable substitute for consistent identifiers.
Watch for similar editions
Regional, time-shifted and high-definition editions can share a familiar brand while following different schedules. Mapping all editions to one guide key may make the listings look plausible but wrong. Keep the station edition alongside the identifier in your notes.
Apply the smallest correction
If your player supports manual EPG mapping, correct one channel and refresh its guide first. A successful single-channel fix is stronger evidence than changing every identifier at once. Source-side corrections should go through the service rather than being lost on a later refresh.
A practical sequence
- Compare the playlist tvg-id with the XMLTV channel id.
- Map one affected station and refresh the guide.
- Keep regional or time-shifted editions separate.
An example
A playlist entry labelled City News HD can map to channel id city.news.east. The two names need not match, but the guide key must resolve to the intended edition.
Questions about this topic
Is tvg-id the visible channel name?
Usually not. It is commonly used as a guide-matching identifier.
Why does video work without listings?
Playback and guide data are separate resources.
