XMLTV troubleshooting

The XMLTV display name matches but the guide is empty

A label in the programme's channel field cannot join to a different ID.

A label in the programme's channel field cannot join to a different ID.

Reproduce the condition

The XMLTV sample below is a small synthetic file. It carries no active media source or account data.

<tv>
  <channel id="news.example"><display-name>Example News</display-name></channel>
  <programme start="20250715180000 +0000" stop="20250715190000 +0000" channel="Example News"><title>Evening test</title></programme>
</tv>

What the local check found

Reproducible check against the packaged fixture and parser.
Expected signalObserved signal
Programme channel does not match an IDProgramme channel does not match an ID

What to do next

Compare the programme channel attribute with the channel element's id. Rename the display label only if the interface needs a different name.

What to share if the problem continues

  • The exact parser result and version of the importer or player.
  • A minimal redacted sample with dates, IDs or segment names retained as needed.
  • The output after checking the source export separately from the viewer app.

Sources and further reading