EPG troubleshooting

Empty or incorrect TV guide: troubleshoot M3U and XMLTV

A methodical way to diagnose missing programmes, time shifts and programmes attached to the wrong channel.

Written and verified by the DringTV engineering team · Updated 1 August 2026 · 8 min read

Short answer

A correct EPG needs three links in the chain: a reachable XMLTV source, the same channel identifier in the playlist and XMLTV file, and correct time handling. Check those levels in that order instead of repeatedly refreshing the app.

Key points

  • Playback and programme data are independent resources.
  • The playlist tvg-id must match the XMLTV channel id.
  • A uniform time shift usually points to a time zone or offset problem.
  • Never post a private XMLTV URL in a forum or screenshot.
01

The three links in the programme-guide chain

The playlist describes media entries. XMLTV describes channels and their programmes. The player must match both sides through a stable identifier, then convert programme times for the device time zone.

Display names are not enough. Two different names can match through the same technical id, while identical names can fail when their ids differ.

02

A five-minute diagnostic

  1. Confirm that the media entry plays; otherwise EPG is not the first problem.
  2. Check that the playlist declares a guide through url-tvg, or that the source owner supplies an authorised XMLTV URL separately.
  3. Check only the URL domain in a browser without exposing the full private address or parameters.
  4. Refresh the playlist and guide, then let synchronisation finish.
  5. Compare one playlist tvg-id with the matching XMLTV channel id.
03

Read the symptom

SymptomLikely causeUseful check
No programmes anywhereMissing, unreachable or empty XMLTVDeclared address, network status, file size and dates
Only some entries are emptyMissing or mismatched tvg-idExact identifier match
Every programme is shiftedSource time zone or offset problemXMLTV time, device zone and daylight saving
Programme on the wrong entryDuplicate or incorrect mappingUnique channel id and tvg-id values
Guide empties after a few daysXMLTV no longer renewed or cache expiredLast programme date and refresh frequency
04

What a player can and cannot repair

A player can download, cache, index and display the data it receives. It may infer some name matches, but inference can associate two different channels incorrectly.

It cannot invent missing programmes or permanently repair inconsistent source ids. The reliable fix is for the legitimate source administrator to correct the playlist or XMLTV file.

05

Details that make a useful bug report

  • Source type: M3U, Xtream Codes or Stalker/Ministra.
  • Approximate number of affected entries, without exposing private content.
  • Observed time shift and device time zone.
  • App version and device model.
  • Time of the last successful refresh.
  • Never include a URL, password, token, MAC or screenshot with credentials.

Common questions

Why does playback work without a TV guide?

Playback addresses and programme data are separate resources. One can remain available while the other is missing or expired.

Will changing the TV time zone always fix a shift?

Only when the device zone is wrong. If XMLTV times are incorrectly encoded, the source data has to be corrected.

Technical references