IPTV EPG Explained: XMLTV, Time Zones and Guide Sync

Direct answer: an EPG is a separate XMLTV data file that lists what is on each channel and when. It is downloaded independently of your playlist, so a guide can fail while channels play perfectly. Almost every EPG fault comes down to a missing source, a time zone offset error, or a channel-matching problem.

If your guide is simply blank rather than misaligned, our EPG troubleshooting guide deals with that case directly. This article explains how the guide data actually works.

Where EPG data comes from

The guide is not generated by your player, and it is not carried inside the video stream. It is a file published by an EPG provider and downloaded separately.

Your IPTV provider normally supplies the guide address along with your playlist. In many cases it is the same server address, sometimes with a different path. The player downloads the file, parses it, and matches each programme entry to a channel in your list.

That three-stage process — download, parse, match — is where problems occur. Each stage fails differently.

The XMLTV format explained

XMLTV is the standard format for guide data. It is a plain text file structured as XML, and understanding its shape explains most faults.

A typical file contains two types of block:

• Channel blocks — one per channel, each with an identifier such as tv.example.co.uk. This identifier is what programmes are matched against.
• Programme blocks — one per broadcast, each with a channel identifier, a start time, a stop time, a title and often a description.

Start and stop times are written with an explicit time zone offset:

• 20261007120000 +0000 means midday in GMT
• 20261007120000 +0100 means midday in BST

That offset is the single most common source of UK guide problems, and it is worth understanding properly.

Why UK daylight saving breaks your guide

The UK switches between GMT in winter and BST in summer, and the offset in the XMLTV file changes with it. When the two disagree, the whole guide shifts by an hour.

If everything is exactly one hour out, the cause is one of these:

• The guide source is still publishing the previous offset after a clock change
• Your device time zone is set to somewhere other than London
• The device clock has not updated automatically

The fix: set the device to update time automatically, confirm the time zone is London, then force a full EPG refresh rather than a partial one.

How channels are matched to guide data

Matching happens by channel identifier first and channel name second. When your playlist uses a name the guide provider does not recognise — an extra word, a regional suffix, a different abbreviation — no match is made and that channel shows no information.

This is why a guide can be complete for most channels and empty for a handful. It is not a fault in the data; it is a naming mismatch.

What you can do about it:

• Use a player with an EPG assignment or channel mapping tool, and link the channel manually
• Report a consistent mismatch to your provider, who can correct it at source
• Check whether the affected channels share a naming pattern, which confirms the cause

How to sync your EPG manually

1. Open the player and go to Settings.
2. Find EPG, TV Guide or XMLTV.
3. Confirm a guide source address is present. If it is empty, request the correct address from your provider.
4. Set the update interval to 12 or 24 hours so it refreshes overnight.
5. Select Update EPG or Refresh guide.
6. Stay on the screen. Many players cancel the download if you navigate away.
7. Wait one to five minutes, then open the guide and check a channel you know well.

Our TiviMate setup guide and IPTV Smarters guide walk through the settings for the two most common players.

Common EPG faults and their causes

Troubleshooting checklist

• Confirm a guide source address is present and complete
• Re-enter the address manually, watching for truncated links
• Set the device to update time automatically and to the London time zone
• Force a full EPG update and do not leave the screen
• Clear the app cache if storage is tight
• Restart the device and the router
• Test the same login in a second player to isolate the app
• Ask your provider for the current guide address after any clock change

Common mistakes

• Assuming the guide is part of the playlist. It is a separate download and often needs its own address.
• Navigating away during an update, which cancels it in many players.
• Ignoring the device clock. A wrong time breaks the grid in ways that look like data corruption.
• Expecting guide data for every channel. Smaller and regional channels frequently have none published.
• Reinstalling the app before checking the source address.

The bottom line

An EPG is a data file with three stages: download, parse and match. Identify which stage is failing — no source, wrong offset, or unmatched channel — and the fix follows immediately. The blank guide guide covers the first of those in more depth.

Frequently asked questions

What is an IPTV EPG?

What is XMLTV?

Why is my IPTV guide an hour out after the clocks change?

How do I sync my EPG manually?

Why do some channels have no guide data?