Setup Guide
7 Min Read
Editorial Guide

IPTV EPG Not Working: Fix a Blank, Wrong or Stale TV Guide

The IPTV EPG is the programme guide that sits beside the channel list. When it is blank, hours out of step or missing whole groups, the cause is nearly always one of four things: a stale refresh, a timezone offset, a wrong XMLTV URL or unmapped channels. Test them in that order.

Published November 16, 2026 · Editorial policy

Telegram WhatsApp
IPTV EPG Not Working: Fix a Blank, Wrong or Stale TV Guide
At a Glance
Setup Guide
Read
7 min
Sections
11
Plans From
€15.14

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 seeWhat it usually means
No guide data on any channelMissing or wrong XMLTV URL, or a refresh that never ran
Guide present but wrong timesTimezone offset, usually a whole number of hours
Some channels have data, others do notChannel identifiers not mapped between list and guide
Guide correct yesterday, empty todayThe feed URL changed, or the app stopped refreshing
Programme titles in another languageA 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.

  1. Open the player settings and find the guide, EPG or XMLTV section.
  2. Clear the existing guide data if the app offers that option.
  3. Choose refresh or update now, then leave the app open for five minutes.
  4. 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.

SymptomLikely offsetFix
Everything is exactly one hour earlyBritish Summer Time not appliedSet the app to your city, not a fixed UTC offset
Everything is five hours earlyServer time used instead of local timeChange the app timezone to your region
Everything is a day outDevice date wrongSet the device clock to automatic
Evening shows appear in the morningTwelve-hour format or AM/PM confusionSwitch 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.

  1. Compare the URL in the app with the one in your setup details, character by character.
  2. Remove any trailing space, quote mark or line break picked up from an email.
  3. Confirm the URL opens a file in a browser on another device on the same network.
  4. 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.

  1. Note which channels have no data and whether they share a group or a region.
  2. In the app, open the channel's properties and look for an EPG or guide ID field.
  3. If manual mapping exists, assign the matching guide channel and save.
  4. 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 typeWhere the guide livesCommon quirk
Xtream-based playersGuide arrives with the loginRefresh interval hidden in playlist settings
M3U playersSeparate XMLTV URL fieldURL must be pasted whole, without line breaks
Television appsGuide built from the portalTimezone often follows the television, not the app
Desktop playersGuide settings in preferencesLarger 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.

IPTV EPG questions

Why is my IPTV guide empty?
Usually because the guide has not refreshed, the XMLTV URL is missing or wrong, or the app has no guide source at all. Force a manual refresh, wait five minutes, then check the URL. A guide that emptied overnight often means the feed address changed.
Why is my IPTV guide showing the wrong times?
That is a timezone offset rather than missing data. Set the app's timezone to your city rather than a fixed UTC offset, and check the device clock. A one-hour error is usually daylight saving; a five-hour error is usually server time.
What is an XMLTV URL?
It is the address of a programme guide file in XMLTV format, which players download and match against your channel list. It is separate from the stream itself, so video can play perfectly while the guide stays blank.
Why do only some channels have guide data?
Those channels are not mapped between the channel list and the guide feed. Some apps let you assign a guide channel manually. If yours does not, report the channel names so the identifier list can be corrected at the source.
Do I need an EPG to watch IPTV?
No. Channels play without guide data; you simply lose the schedule, reminders and catch-up labels. A guide is what makes a large lineup usable, which is why it is worth fixing rather than ignoring.
How often should the guide refresh?
Once a day is enough for most households and much lighter on the connection than refreshing at every launch. Daily refreshes also avoid the stall some older devices show when a large guide download competes with playback.
Can I use a free guide source instead?
Sometimes, if your player accepts a third-party XMLTV feed. Coverage varies by country and channel, and the identifiers rarely match a provider's lineup exactly, so expect to map channels manually. Use the guide supplied with your login first.
Next Step

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.