EPG Explained: How IPTV Program Guides Work (and How to Fix Them)

The EPG — Electronic Program Guide — is the grid that tells you what’s on: titles, times, descriptions, and what’s coming next. It’s also the part of an IPTV setup most likely to be broken, because it travels separately from the channels themselves.

How guide data actually works

Your M3U playlist carries the channels; the EPG arrives as a second feed, almost always in XMLTV format — an XML file listing programmes per channel:

<programme start="20260721190000 +0000" stop="20260721210000 +0000" channel="espn.us">
  <title>Monday Night Baseball</title>
  <desc>Phillies vs Dodgers, live from Citizens Bank Park.</desc>
</programme>

The app stitches the two feeds together by ID: the playlist entry with tvg-id="espn.us" gets matched to programmes tagged channel="espn.us". That matching step is where guides break. If the playlist calls a channel ESPN.US and the guide calls it espn.us, the channel plays fine but shows an empty guide — the streams and the schedule simply never got introduced.

The three classic EPG problems, fixed

1. Empty guide everywhere. The app has no EPG source. Get the XMLTV URL from your provider (with Xtream Codes logins the app usually finds it automatically), add it under EPG settings, and force a refresh — first downloads can take minutes for big lineups.

2. Times shifted by hours. Guide data ships in UTC; your app is rendering it raw. Set the EPG time offset to your timezone in the player settings — one setting fixes every channel at once.

3. Some channels blank, others fine. ID mismatch between playlist and guide. Good players let you remap a channel’s EPG source manually — pick the channel, choose the matching guide entry once, done.

Catch-up depends on the EPG

Providers that offer catch-up (replaying the last days of a channel’s schedule) build it on guide data — the EPG entry is what tells the app which two hours to fetch. Broken EPG usually means broken catch-up too, which is why it’s worth fixing rather than living without.

Choosing guide sources

Provider EPGs vary from excellent to abandoned. If yours is chronically wrong, third-party XMLTV services cover thousands of channels — often better maintained than the provider’s own. Whatever the source, refresh cadence matters more than anything: a guide is only as good as its last update, so set the app to auto-refresh daily. For the device-side settings per app, see our device guides.