IPTV EPG: What It Is & How to Fix It
IPTV EPG is the on-screen program guide showing what's playing now and next. Learn how it works, why it breaks, and how to fix it fast. Updated for 2026.
An IPTV EPG is the electronic program guide attached to your IPTV service. It shows what’s on each channel right now and what’s coming up next, displayed as a scrollable grid inside your player. Without a working IPTV EPG, you’re watching blind, no schedule, no program names, no way to set recordings.
How IPTV EPG actually works
Your IPTV service delivers two separate things: a stream (the video) and a guide (the schedule). These are not the same file. The stream comes from your M3U playlist or Xtream Codes credentials. The guide comes from an XMLTV source, either a URL your provider supplies or one you add manually.
When your player loads, it reads the channel IDs inside your M3U file and tries to match them against the channel IDs in the XMLTV data. If the IDs match, program names and times appear in the guide grid. If they don’t, the grid stays blank or shows “No Information.”
That matching step is where most EPG problems start. The M3U might label a channel CNN_US while the XMLTV file uses cnn.us. Those are treated as two different channels, so nothing shows up.
What is inside an XMLTV file
An XMLTV file is plain XML. Each entry contains:
- A channel ID and display name
- A program title
- A start time and stop time in UTC
- An optional description, episode number, and category
Your player parses this file and renders it as the visual guide grid. Larger files covering many countries can run to several megabytes, which is why players cache them locally and refresh on a schedule rather than fetching them on every launch.
Why your IPTV EPG is blank or wrong
Blank EPG is one of the most common complaints among IPTV users. The causes fall into a few categories.
No EPG URL configured. Some players require you to enter the EPG URL separately from the M3U. If you only added the playlist, the guide section stays empty. Check your player’s playlist or source settings and look for a field labeled EPG URL or XMLTV URL.
Channel ID mismatch. As described above, the IDs in the M3U and the XMLTV file must match exactly. This is case-sensitive in some players. If your provider gives you both files, they should already be matched. If you added a third-party XMLTV source manually, mismatches are likely.
Stale cache. Players cache EPG data locally. If the cache is old and the player hasn’t refreshed, you may see yesterday’s schedule or nothing at all. Go into settings and trigger a manual EPG refresh.
Provider-side issue. Sometimes the EPG feed the provider hosts goes down or falls behind. If everything on your end looks correct but the guide is still empty, contact your provider. A licensed provider like Vivimate keeps its EPG feed maintained and will respond quickly if something breaks on their end.
Time zone offset. EPG data is stored in UTC. If your player is set to the wrong time zone, the guide will show the wrong programs at the wrong times. Fix the time zone in your player settings, not in the XMLTV source.
How to set up IPTV EPG in common players
The exact steps vary by app, but the logic is the same across all of them.
TiviMate
- Open TiviMate and go to Settings, then Playlists.
- Select your playlist and tap EPG.
- Enter the XMLTV URL your provider gave you.
- Save and go to Settings, then EPG, and tap Refresh EPG.
TiviMate also lets you add multiple EPG sources if one source doesn’t cover all your channels. Each source is fetched separately and merged into a single guide.
IPTV Smarters Pro
When you add a new playlist using the M3U URL method, there is a field for EPG URL on the same screen. Paste it there before saving. If you used Xtream Codes login instead, the EPG is usually pulled automatically from the provider’s server.
GSE smart IPTV
Go to Remote Playlists, tap the info icon next to your playlist, and add the EPG URL in the XMLTV field. GSE refreshes EPG data automatically, but you can trigger a manual refresh from the same screen.
Understanding EPG sources: Provider vs. custom
Your IPTV provider may supply their own EPG feed, or they may not include one at all. There’s a meaningful difference between the two.
Provider-supplied EPG is pre-matched to the channel IDs in the M3U, so it should work without any manual configuration. This is the most reliable setup. When you subscribe to Vivimate, the EPG URL is included in your account details and is already matched to the channel lineup.
Custom XMLTV sources are third-party feeds you add yourself. These can fill gaps when a provider’s EPG misses certain channels, but they require manual channel matching. If the IDs don’t align, you may need to use your player’s channel editor to map them by hand. That’s more work, and it depends on the third-party source staying online and reasonably up to date, which isn’t guaranteed.
For most users, a provider that supplies a matched EPG is the practical choice. It removes the matching problem entirely.
Troubleshooting IPTV EPG problems step by step
If your guide is blank or showing wrong data, work through this sequence.
- Confirm your player has an EPG URL entered, not just an M3U URL.
- Force a manual EPG refresh inside the player settings.
- Check that your player’s time zone matches your local time.
- Look at one channel that should definitely have EPG data, such as a major news channel, and see if that specific channel is missing or if all channels are missing.
- If only some channels are missing, the issue is likely ID mismatch on those specific channels.
- If all channels are missing, the EPG URL itself is probably unreachable or incorrect.
- Copy the EPG URL into a browser. If it loads a file or triggers a download, the URL is valid. If you get a 404 or connection error, the feed is down.
- Contact your provider if the URL is dead or if refreshing doesn’t fix the problem.
Don’t add random third-party XMLTV sources to patch a broken provider EPG. It rarely solves the underlying issue and often creates new mismatches. The real fix is a provider whose EPG feed is actually maintained.
Frequently asked questions
What is an IPTV EPG? EPG stands for Electronic Program Guide. In an IPTV context, it is the on-screen grid that shows channel names, current programs, and upcoming schedules, usually pulled from an XMLTV file or a URL your player fetches automatically.
Why does my IPTV EPG show ‘No Information’? The most common causes are a missing or expired EPG URL in your player, a mismatch between the channel IDs in your M3U playlist and the EPG source, or a provider that has not mapped their channels to an EPG feed at all.
What is XMLTV and how does it relate to EPG? XMLTV is the standard file format used to deliver EPG data. It is an XML file that contains channel IDs, program titles, start and stop times, and descriptions. Your IPTV player reads this file and displays the data as a visual guide.
How often does IPTV EPG data update? Most EPG sources refresh every few hours. Your player also has its own refresh interval, typically configurable between 12 and 48 hours. If your guide looks stale, force a manual refresh inside the player settings.
Does Vivimate include EPG in its subscription? Yes. Vivimate includes an EPG feed with active subscriptions. The EPG URL is provided in your account details and works directly with major players including TiviMate, IPTV Smarters, and GSE Smart IPTV.