A working IPTV EPG turns a list of channel names into a schedule you can browse, record from and plan around. When it fails you get one of three symptoms: no programme data at all, programme data that is hours out of step with the clock, or gaps where individual channels should be. Each has a different cause and a different fix.
The 60-second answer
Reload the guide from the player's settings and wait five minutes. Check the timezone and set it to your actual location, not the server's. Confirm the XMLTV URL is the one you were sent, complete and unmangled. Then check channel mapping for the channels with gaps. Reboot the device before assuming the provider is at fault.
What is an IPTV EPG and where does it come from?
The EPG is a separate data feed from the video stream. Your player downloads a file, usually in XMLTV format, that lists programme titles and start times against channel identifiers. If the file is missing, stale or keyed to different identifiers than your channel list, the video still plays and the guide stays empty.
| What you see | What it usually means |
|---|---|
| No guide data on any channel | Missing or wrong XMLTV URL, or a refresh that never ran |
| Guide present but wrong times | Timezone offset, usually a whole number of hours |
| Some channels have data, others do not | Channel identifiers not mapped between list and guide |
| Guide correct yesterday, empty today | The feed URL changed, or the app stopped refreshing |
| Programme titles in another language | A guide feed for a different region |
Because the guide is separate, a blank EPG tells you nothing about the health of the video service. Test a channel first: if it plays, the problem is confined to the guide data and the fixes below apply.
Fix 1: reload the guide properly
Most players refresh the guide on a schedule rather than continuously, so a change made five minutes ago may not appear until tomorrow. Force a refresh from settings, then leave the app open for a few minutes so the download can finish. On a large lineup the file can take a while on a slow connection.
- Open the player settings and find the guide, EPG or XMLTV section.
- Clear the existing guide data if the app offers that option.
- Choose refresh or update now, then leave the app open for five minutes.
- Reopen the guide and check a channel you know has programming now.
Stop here if the guide fills in after the refresh. Set the refresh interval to daily so the same problem does not return in a week, and avoid setting it to refresh on every launch, which slows startup.
Fix 2: correct the timezone
A guide that shows the right programmes at the wrong times is not broken, it is offset. Set the timezone in the app to your location rather than leaving it on a default, and check whether the device itself has the right clock. A device with the wrong date will produce a guide that looks corrupted.
| Symptom | Likely offset | Fix |
|---|---|---|
| Everything is exactly one hour early | British Summer Time not applied | Set the app to your city, not a fixed UTC offset |
| Everything is five hours early | Server time used instead of local time | Change the app timezone to your region |
| Everything is a day out | Device date wrong | Set the device clock to automatic |
| Evening shows appear in the morning | Twelve-hour format or AM/PM confusion | Switch the app to 24-hour display |
Stop here if the guide lines up with the clock after the timezone change. This is the single most common EPG complaint, and it is a setting rather than a fault. Note that catch-up and reminders can stay offset even when live times look correct, so check one of each before closing the settings.
If your region changes clocks twice a year, the guide will drift by an hour on the morning of the change. That is not a fault and does not need a support ticket: set the timezone to your city so the app follows the change automatically, then refresh the guide once the clock has moved.
Fix 3: check the XMLTV URL
If the app expects a guide URL, it has to be exact. Copy and paste it rather than retyping, and check that the end of the address has not been cut off. Some apps also require the URL to end in .xml or .xml.gz, and will silently refuse anything else.
- Compare the URL in the app with the one in your setup details, character by character.
- Remove any trailing space, quote mark or line break picked up from an email.
- Confirm the URL opens a file in a browser on another device on the same network.
- Paste it again, save, then force a refresh.
Stop here if the URL opens a guide file in a browser but the app still shows nothing. That points at the app rather than the feed, and a second player is the quickest confirmation. The setup guide covers where the guide field sits in a typical install.
Fix 4: map the channels with gaps
Partial guide data is a mapping problem. The channel list identifies a channel one way and the guide identifies it another, so the player cannot join them. Some apps let you map manually; others rely on the provider keeping identifiers consistent.
- Note which channels have no data and whether they share a group or a region.
- In the app, open the channel's properties and look for an EPG or guide ID field.
- If manual mapping exists, assign the matching guide channel and save.
- If it does not, report the channel names and group to support.
Stop here if only a handful of channels are affected and everything else is correct. That is worth reporting but not worth reinstalling an app that is otherwise working. Mapping problems are fixed at the source, usually by correcting an identifier list.
Player-specific notes
Apps handle guide data differently, and the setting you need is often one level deeper than expected. The table below covers the patterns rather than every version, because menus move between releases. If your app is not listed, look for a section marked EPG, Guide or XMLTV in its playlist settings before giving up.
| Player type | Where the guide lives | Common quirk |
|---|---|---|
| Xtream-based players | Guide arrives with the login | Refresh interval hidden in playlist settings |
| M3U players | Separate XMLTV URL field | URL must be pasted whole, without line breaks |
| Television apps | Guide built from the portal | Timezone often follows the television, not the app |
| Desktop players | Guide settings in preferences | Larger buffer, slower first refresh |
If your app is one of the common ones, the TiviMate notes and the IPTV Smarters notes cover the exact menus. If the guide section is missing entirely, the app may not support XMLTV, and the player comparison lists alternatives that do.
When the guide is the provider's fault
A provider-side guide fault looks different from an app fault: it affects every device on the same account, it persists across a reinstall, and it usually starts suddenly. A guide that worked for weeks and then emptied overnight is more likely a feed change than a setting you touched.
Send the channel names, the group, the time you checked and a screenshot of the empty guide. That is enough for the feed to be checked without a long exchange. If the video is also failing, work through the not-working guide first, because a guide problem on a dead stream is not a guide problem at all.
Guide data, catch-up and recording
Catch-up and scheduled recording both depend on the guide timestamps, so a one-hour offset breaks them even when live television looks correct. If a catch-up programme starts mid-episode, check the timezone before you blame the recording. A recording that fires at the right time but captures the wrong show is usually the same offset seen from the other direction.
Players that support reminders depend on guide data too. On a channel with no mapping, the reminder option is often greyed out, which is a useful way to confirm that the gap is a mapping problem rather than a general guide failure.
A short maintenance routine
Ten minutes a month keeps the guide accurate. Refresh the data manually, check the timezone after any daylight saving change, and hide groups you never watch so the app has less to download. If a device clock drifts, set it to automatic rather than correcting it by hand.
Keep the guide URL somewhere you can find it, because the day you need it is the day the app has forgotten it. If you are weighing up whether the guide quality justifies staying, the subscription page explains what each term includes, and support can confirm what guide data your plan carries.
Related reading
IPTV EPG questions
Why is my IPTV guide empty?
Why is my IPTV guide showing the wrong times?
What is an XMLTV URL?
Why do only some channels have guide data?
Do I need an EPG to watch IPTV?
How often should the guide refresh?
Can I use a free guide source instead?
Check the guide before you commit
A trial is long enough to confirm that the schedule loads, matches the clock and covers the channels you watch.