IPTV EPG Not Working? How the Guide Works and How to Fix It
The channels play, but the guide is blank, late or wrong. That is an EPG problem, and it is separate from stream quality. This guide explains where IPTV guide data comes from and how to work through each common fault.
Key idea
The guide is not part of the video stream. It is a separate data source that your player matches to channels, so most guide faults come down to matching, timing or refresh problems.
What Is an EPG?
An electronic program guide is a menu that shows schedule information for current and upcoming programmes. Wikipedia notes that modern guides usually cover about seven to 14 days, and that listings can be delivered over the internet. In IPTV, that internet route is how guide data normally reaches your player.
Where IPTV Guide Data Comes From
- Your provider's login. With an Xtream-style login, guide data is often delivered through the same connection, though this depends on the provider and app. See Xtream Codes vs M3U.
- An XMLTV file. XMLTV is an XML-based TV listings format introduced in 2002. Providers often give you a guide URL to paste into the player.
- Channel IDs in a playlist. IPTV playlists commonly carry a
tvg-idattribute on each channel, which players typically use to find the matching guide entry.
That last link explains most mismatches. In the XMLTV format description (its DTD file), each programme names its channel with a channel attribute, and a matching channel entry, where present, should carry the same ID. If a playlist channel's ID does not exist in the guide data, the player has nothing to show for it. Exactly how a given app does this matching is not standardised, so check your player's documentation.
Symptoms, Likely Causes and What to Try
These are likely causes, not diagnoses. Your player and provider decide which apply.
| Symptom | Possible cause | What to try |
|---|---|---|
| Guide completely empty | No guide source set, source unreachable or expired, or the refresh failed | Confirm the guide URL or Xtream-style login, then force a refresh |
| Times off by whole hours | Time zone mismatch between guide data and player | Check the time zone; use a guide time-shift option if your player has one |
| Wrong shows on one channel | Channel matched to the wrong guide entry | Re-map the channel if possible, or report it to the provider |
| Some channels have no data | The guide source may not include them | Ask the provider whether guide data exists for those channels |
| Guide loads very slowly | A large guide on a slow device is one possibility | Wait for the refresh to finish; update the app; try fewer days or channels if your player allows |
| Old programmes shown | Stale stored data | Clear the guide data or app cache and reload |
Why Times Can Be Off
According to the XMLTV format description (its DTD file), times are written as YYYYMMDDhhmmss or a shorter prefix of that, and a time zone can be appended. If no explicit time zone is given, UTC is assumed. Its examples include 19880523083000 +0300. A guide that omits or mislabels its offset can therefore look shifted by whole hours until the player or a setting corrects it. That is why a consistent offset is a time zone clue, while random wrong shows on a single channel is a matching clue.
A Fix Order That Saves Time
- Refresh the guide inside the player and wait for it to finish; large guides can take a while on small devices.
- Confirm the source. If you use a separate guide URL, check it with your provider; if you use a login, re-enter it exactly.
- Check the time zone on the device and in the player.
- Clear the app cache or stored guide data, then reload.
- Re-map individual channels if the player supports manual guide matching.
- Contact the provider with the channel names that fail and the times you see. Our review checklist includes guide accuracy as a scoring item.
If streams also stall, treat that separately with the buffering checklist. App-specific steps are in the player app guide and the Smarters Pro guide.
Test the Guide Before You Pay
Guide quality varies between services, so check it during a trial: scan several channels across different days, compare a few programme times with an official source, and note any channel with no data. The free trial guide explains how, and you can see our plans when you are ready. Device steps are in the setup guides.
Frequently Asked Questions About IPTV EPG
What is an EPG in IPTV?
EPG stands for electronic program guide: the menu of current and upcoming programmes. In IPTV the guide data is usually supplied separately from the video streams and your player matches it to your channel list.
What is XMLTV?
XMLTV is an XML-based file format for TV listings, introduced in 2002 according to Wikipedia. Its published format description gives each programme a start time and a channel reference, and many IPTV setups use an XMLTV file, or something close to it, as their guide source.
Why is my IPTV guide empty?
Common causes are no guide source set, an expired or unreachable guide source, a refresh that never finished, a playlist-only setup with no guide URL, or channel IDs that do not match the guide data. Work through the fix order below.
Why are the programme times wrong?
A consistent offset of whole hours usually means a time zone mismatch. In the XMLTV format description, a time with no time zone is treated as UTC, so a guide file that omits its offset can appear shifted unless your player or settings correct it. Check your time zone setting and any guide time-shift option your player offers.
Why does one channel show the wrong programmes?
It is probably matched to the wrong guide entry. If your player lets you change a channel’s guide mapping, do that; otherwise report the channel name to your provider.
Test a Service on Your Own Devices
Review our plans, check the terms, and follow our setup tutorials to see the guide working in your player.