What Is an EPG in IPTV? The TV Guide, Explained

Two files, not one

This is the part that catches people out, and understanding it explains most EPG problems on its own. An IPTV subscription hands your player two separate things:

• 1.The channel list — your M3U playlist or Xtream Codes login. This says which channels exist and where their streams live.
• 2.The guide data — an XMLTV file, usually fetched from a URL. This says which programmes air on which channel at which time.

Neither knows about the other until your app joins them up. With an Xtream Codes login the player usually pulls both automatically from the same credentials, which is why Xtream setups tend to "just work". With a bare M3U URL you often have to paste the EPG URL separately — and a playlist loaded without one is exactly why a brand-new install shows a perfect channel list and a completely empty guide.

How channels get matched to listings

The join happens on an identifier, not on the channel name you see. Every entry in your playlist carries a tvg-id, and every programme in the XMLTV file is filed against a channel ID. The app matches one to the other:

# In your playlist:
#EXTINF:-1 tvg-id="BBCOne.uk" group-title="UK Entertainment",BBC One HD

# In the XMLTV guide file:
<programme channel="BBCOne.uk" start="20260824190000 +0100" stop="20260824200000 +0100">
  <title>The Repair Shop</title>
</programme>

Match the ID and the programme appears. Miss it by a character and the app has the listing in memory with nothing to attach it to, so the channel renders as "No information" while the channel beside it is fine. This is why guide gaps are so often patchy rather than total — and why the fix is refreshing the playlist and the EPG together rather than just the guide.

It also explains regional variants. BBC One London and BBC One Scotland are different IDs, so picking the wrong variant gives you a working stream with subtly wrong listings. If one channel is consistently off while everything else is right, check you are on the variant you think you are. For the full troubleshooting sequence, see IPTV EPG not working.

Why the times drift — and the British Summer Time trap

Look again at the timestamp above: 20260824190000 +0100. That is 19:00 at a UTC offset of one hour — 7pm British Summer Time. XMLTV always carries the offset, and your player converts it to whatever local time your device is set to.

Two things can go wrong, and they look identical on screen. Either your device is in the wrong time zone, or the player has a manual EPG time-shift setting someone nudged to "fix" an earlier problem. Both produce a guide that is out by a clean whole number of hours — every programme, every channel, the same offset. That uniformity is the diagnostic: a one-hour shift across the entire grid is a clock problem, never a data problem.

The classic UK version bites twice a year. A device pinned to UTC rather than "London" reads correctly all winter and goes an hour out the moment the clocks go forward in late March. Set the device to automatic date and time with the UK time zone selected, then reset any time-shift offset in the player back to zero.

How far the guide should run

Seven days ahead is the working expectation for a maintained service. Flickhaven supplies a full 7-day EPG. Less than about two days forward usually means the guide source is thin rather than that anything is broken on your side, and it is a fair thing to ask a provider about before subscribing.

Guides can also run backwards, and that part matters more than people expect. A day or two of past listings is what lets catch-up playback appear inside the guide grid — you scroll left to yesterday evening and press play on the programme itself. Without past guide data the archive may still exist, but you have to find it through a separate catch-up menu instead.

Which players handle the EPG best

Every player reads the same XMLTV file. What differs is how much they do with it — how far the grid scrolls, whether the guide drives recording and catch-up, and how gracefully they cope with a large guide on modest hardware.

Player choice is worth getting right — see the best IPTV apps compared for the wider picture.

EPG, catch-up and DVR are three different things

These get used interchangeably and they are not the same, which causes a lot of mismatched expectations:

• ·The EPG is information — a schedule. It tells you what aired. It stores nothing.
• ·Catch-up is a server-side archive your provider keeps, on supported channels, for a limited window. Nothing is stored on your device.
• ·DVR is you recording to your own storage, which is why it keeps working after any archive window closes.

The guide is the connective tissue between all three: it is what you schedule a recording from, and what you scroll back through to reach catch-up. A broken EPG therefore breaks features that appear unrelated to the guide, which is exactly why an empty grid is worth fixing properly rather than living with.

FAQ