.webp)
If you have ever flicked through twenty channels just to find out what is on, you already understand why the programme guide matters. In an IPTV player the guide — usually called the EPG — turns a long list of channel names into something that feels like proper television: a grid of what is on now, what is next and what is coming up later tonight.
This guide explains where that information comes from, how your player matches it to channels, and what to do when it goes blank or shows the wrong times.
What EPG stands for
EPG means Electronic Programme Guide (or Electronic Program Guide in American English). It is the on-screen schedule you see in cable boxes, satellite receivers and IPTV apps.
In an IPTV app, the EPG usually appears in two places:
- The guide grid — channels down the side, time across the top, programmes as blocks.
- The now/next banner — the strip that appears when you change channel, showing the current programme, a progress bar and what follows.
Neither of these is part of the video stream. The guide is a separate set of data that your player downloads and lines up with the channels.
Where IPTV guide data comes from
Most IPTV guides use a format called XMLTV. An XMLTV file is a structured text file that lists channels and programmes: a start time, an end time, a title, and often a description, category or episode number.
Your player gets this data in one of two ways:
- Automatically with an Xtream Codes login. When you sign in with a server address, username and password, the player can request guide data from the same server. For most people, this simply works without any extra steps.
- From a separate EPG address with an M3U playlist. An M3U link only lists channels and stream addresses. If you use one, you normally add a second address for the guide in the player’s EPG or “TV guide” settings. These files often end in
.xmlor.xml.gz(a compressed version).
If you are not sure which login you have, our comparison of M3U playlists and Xtream Codes explains the difference.
How your player matches guide data to channels
This is the part that causes most EPG problems, so it is worth understanding.
Every channel in an XMLTV file has an ID — something like news24.uk. Every channel in your playlist also carries an ID, usually stored in a field called tvg-id. When the two IDs match, the player knows which schedule belongs to which channel.
If they do not match — because of a small spelling difference, a renamed channel or a channel that simply is not in the guide file — the player cannot place any programmes on that row, and you see “No information” or an empty bar.
Some players try to match channels by name as a fallback. That helps, but names vary (“News 24 HD” vs “News24”), so ID matching is always more reliable.
Why the EPG is wrong or missing
The guide has not finished loading
Guide files can be large. On the first launch, or after clearing the app’s data, the player may take a minute or two to download and process everything. Channels play before the guide is ready, which makes it look broken when it is simply still loading.
Fix: leave the app open for a few minutes, then reopen the guide.
Programme times are shifted by an hour or more
This almost always comes down to time zones. XMLTV times include a time zone, and players convert them to your local time. If your device’s time zone is wrong, or the player applies an offset on top, every programme appears early or late by the same amount.
Fix:
- Check the date, time and time zone in your device’s system settings first.
- Then look for an EPG time offset or time shift setting in the player and set it to zero.
- Only adjust the offset if everything is still consistently wrong after that.
If times are off by exactly one hour for a few weeks a year, a daylight-saving setting is the likely culprit.
Some channels have guide data, others do not
That is usually the ID mismatch described above, or a channel that the guide source does not cover — this is common for smaller or special-event channels.
Fix: refresh the EPG. If a specific channel stays empty, many players let you manually assign a guide channel to it (sometimes called “EPG mapping” or “choose EPG source”). Otherwise, let your provider know which channel is missing.
The guide stops after a day or two
Guide files cover a limited window, often a few days ahead. If the player has not refreshed for a while, the listings simply run out.
Fix: set the guide to update automatically once a day, or refresh it manually.
The guide is empty after changing devices or reinstalling
A fresh install starts with no cached guide data, and M3U setups lose the separate EPG address if you only re-entered the playlist.
Fix: re-add the EPG address in the player’s settings, then refresh.
EPG settings worth adjusting
Most IPTV players include a handful of guide settings. These are the ones that make a noticeable difference:
| Setting | What it does | Recommended |
|---|---|---|
| Update interval | How often the guide is downloaded again | Once every 24 hours |
| Days to keep | How much past and future data is stored | 1 day back, a few days ahead |
| Time offset | Shifts all programme times | 0, unless times are consistently wrong |
| Update on start-up | Refreshes the guide each time the app opens | Off on low-power devices |
| Show programme descriptions | Loads extra detail for each programme | On for TVs, optional on phones |
On devices with limited memory, such as older Fire TV Sticks, keeping fewer days of data helps the guide scroll smoothly.
Making the guide genuinely useful
A working EPG is more than a schedule. A few habits turn it into the fastest way to watch:
- Hide channel groups you never watch. A shorter guide is quicker to scroll and quicker to load. Our guide to organising IPTV channels walks through favourites and hidden groups.
- Use reminders. Many players let you set a reminder on a programme in the guide, so a match or a film does not slip past.
- Search the guide. Better players can search programme titles, not just channel names — useful for finding a specific film or fixture.
- Check catch-up icons. On channels that support it, a small icon in the guide shows programmes you can still watch after they aired. Our explainer on catch-up TV covers how that works.
When the problem is not the guide
If channels themselves will not play, or they play but buffer, the EPG is not the cause. Start with our IPTV connection problems guide for streams that will not start, or the buffering guide for streams that keep pausing.
The short version
The EPG is schedule data, delivered separately from your channels and matched to them by channel IDs. When it is missing, give it time to load and refresh it. When times are wrong, fix the device’s time zone before touching offsets. And when a single channel stays blank, it is almost always an ID that does not match — something your provider can help with.