You open your IPTV player, the channels play perfectly, but the guide grid is empty. Or it says a cooking show is on when you are clearly watching the evening news. Both problems come from the same place: the EPG. This guide explains what the EPG is, where your player gets it from, and how to fix the most common guide problems in a few minutes.
What is an EPG?
EPG stands for Electronic Program Guide. It is the schedule data that tells your player what is showing on each channel right now, what comes next, and what aired earlier. In most players it appears as a scrolling grid, a “Now / Next” bar at the bottom of the screen, or a list beside the channel name.
The EPG is separate from the video itself. Your channels come from one source (the stream URLs in your playlist) and the guide comes from another (a schedule file). That separation explains why channels can play fine while the guide is blank: one source works and the other does not.
How IPTV guide data is delivered
Almost every IPTV service uses the XMLTV format. It is a large text file listing every channel and every programme with a start time, end time, title, and often a short description. Your player downloads this file, matches each guide entry to a channel in your playlist, and draws the grid.
How your player gets the file depends on how you logged in:
- Xtream Codes login (server, username, password): the guide usually loads automatically. The player requests it from the same server using your credentials, so there is nothing extra to enter.
- M3U playlist URL: the playlist may include the guide address in its header (a
url-tvgorx-tvg-urltag). Some players read it automatically; others need you to paste an EPG URL into a separate field.
If you are not sure which login type you have, our comparison of M3U vs Xtream Codes explains the difference and why Xtream logins tend to give a smoother guide experience.
How channels are matched to the guide
Each channel in an M3U playlist carries a tvg-id value. The XMLTV file uses the same IDs. When the two match, the programme data lands on the right channel. When a channel has no ID, or the ID was changed on one side but not the other, that channel shows “No information” even though the rest of the guide works.
Fix 1: The guide is completely blank
A fully empty guide almost always means the player never downloaded the EPG file. Work through these steps in order:
- Force an update. In IPTV Smarters, open the settings and choose Refresh EPG (or log out and back in). In TiviMate, go to Settings → EPG → Update EPG. Wait a minute or two; the file can be large.
- Check that an EPG source exists. If you logged in with an M3U link, look for an EPG or XMLTV field in the playlist settings. If it is empty, paste the EPG URL your provider sent you.
- Check storage. Guide files for thousands of channels take space. On a Firestick or a low-end Android box with almost no free storage, the download can silently fail. Clear the cache of unused apps.
- Reduce the guide window. Many players let you choose how many days of guide data to keep. Dropping from 7 days to 2 or 3 makes the download faster and more reliable on weaker hardware.
Fix 2: The times are shifted by one or more hours
If the programmes look right but everything is an hour early or late, you have a time-zone offset problem. XMLTV files store times with a zone marker, and the player converts them to your local clock. That conversion breaks when your device’s time zone is wrong or when daylight saving time changes.
- Check the time zone on the device itself (not just the clock). On Android TV and Fire TV this sits under Settings → Preferences → Date & Time.
- If the device is correct, use the player’s EPG time shift setting. TiviMate, IPTV Smarters and most others let you shift the guide by whole hours (for example +1 or −1).
- After a daylight saving change, refresh the guide. Old cached data can keep the previous offset until you update it.
Fix 3: Some channels show the wrong programmes
When most of the guide is fine but a few channels show another channel’s schedule, the IDs are mismatched. Players with advanced guide tools (TiviMate is the best known) let you open a channel, choose EPG source or Change EPG, and pick the correct entry by hand. The choice is saved, so you only do it once.
If the same mismatch appears on several devices and players, tell your provider’s support team. They can correct the ID on the server side so it is fixed for everyone.
Fix 4: The guide loads slowly or the app freezes
A full guide for 26,000+ channels is a heavy file. Players that try to process all of it at once can stall on budget devices. Three things help:
- Hide channel groups you never watch. Many players then skip guide data for hidden channels.
- Keep fewer days of guide data, as above.
- Schedule updates for once a day rather than every time the app opens.
If the whole app also stutters during playback, the problem may be the network rather than the guide. Our buffering fixes cover that side.
Which players handle EPG best?
| Player | Guide strengths |
|---|---|
| TiviMate | Full grid, manual channel-to-guide matching, time shift, multiple EPG sources |
| IPTV Smarters Pro | Automatic guide with Xtream login, simple refresh, works on most platforms |
| OTT Navigator | Flexible grid layouts and catch-up integration |
| VLC | Plays streams well but has no proper guide grid |
For a wider look at what each app does well, see our best IPTV player apps roundup.
Catch-up TV and the guide
Catch-up (also called time-shift or archive) relies on the guide. When you scroll back in the grid and pick a programme that already aired, the player uses the guide’s start and end times to request that window of the recording. A shifted guide means catch-up starts in the wrong place, so fixing the time offset fixes catch-up too.
Frequently asked questions
Why does the guide work on one device but not another?
Each player stores its own copy of the guide. The device that works has a fresh download; the other one needs a manual refresh, more free storage, or the EPG URL entered.
How often should the EPG update?
Once a day is plenty for most people. Guide files cover several days ahead, so more frequent updates just add load on your device.
Do I need a separate EPG subscription?
No. A good IPTV service includes guide data. If you are testing a provider, check the guide during the free trial as well as the picture quality.
Can I test the guide before buying?
Yes. Request a free trial, log in with your usual player, and check that the guide fills in for the channels you watch most. When you are happy, compare plans on our pricing page.