What an EPG is, and why the TV guide is empty
An EPG (electronic programme guide) is the schedule a player shows beside each channel: what is on now, what comes next, and the grid for the days ahead. In IPTV it does not travel with the video. It is a separate file, usually in the XMLTV format, that the provider publishes at its own address, and the player downloads it and matches its entries to your channels. When the guide is empty, one of those steps failed: there is no guide address, the download failed, the file could not be read, or the entries do not match your channels. The channels themselves still play.
Where the guide comes from
Three pieces have to line up:
- A guide address. With an Xtream Codes login, the provider’s guide address comes with the login. With an M3U link, the file may name one in its first line; many do not, and then the player has no guide to fetch until you add one.
- The guide file. An XMLTV file lists channels by an id, then every programme with a start time, an end time, a title and often a description. For a large lineup it is tens of megabytes, often compressed.
- A match between the two. Each channel in your playlist carries a guide id (the
tvg-idin an M3U line). The player looks that id up in the guide. If the ids differ, a player can try the channel’s name, which works only when the names are close.
So a channel can have a working stream and no guide at all. They come from different places.
The five reasons the guide is empty
| What you see | Most likely cause | Whose side |
|---|---|---|
| The whole guide is empty, for every channel | No guide address on the playlist | Yours to add, from the provider |
| The whole guide is empty, and an error mentions the download | The guide address does not answer, or answers with an error | Provider |
| Some channels have a guide, others say they have none | Those channels’ ids are not in the guide file | Provider |
| The guide was there yesterday and ran out | The guide covers too few days, or has not been refreshed | Provider, or a refresh on your side |
| The guide is there but at the wrong hours | A time zone mismatch, not an empty guide | See guide times are wrong |
No guide address
The most common cause with an M3U link. Ask the provider for its XMLTV address; providers that hand out M3U links usually have one. It goes in the playlist’s settings, not in the link.
The download failed
The address exists but answers with an error, takes too long, or returns a web page instead of a file. That is on the provider’s side. A guide download that fails does not stop playback: the channels stay, without the schedule.
Some channels match, others do not
The provider’s playlist and its guide are often maintained separately, and a renamed or new channel ends up in one and not the other. Nothing on the player’s side can invent the missing schedule. Tell the provider which channels have none, by name.
The guide ran out
A guide covers a fixed number of days. Some providers publish one or two; others a week. If nothing refreshes it, the grid empties from the end. Refreshing the guide daily keeps it full as far as the provider publishes.
How to tell which one you have
Work from the widest symptom to the narrowest:
- Is any channel showing a programme? If none is, look at the guide address first. Open the playlist’s settings and check whether one is set, or whether the playlist came with one.
- Did the download report an error? A failed download is the provider’s address not answering. In Adless that is E-EPG-FETCH, which also covers a file that arrives but cannot be read.
- Do most channels have a schedule and a few do not? Then the guide works and those channels are missing from it. Compare a working and a missing channel: if the missing one was renamed or added recently, that is the reason.
- Is the schedule there but blank from some point on? Check when the guide was last updated, refresh it, and see whether the provider’s file reaches further.
The guide shows the wrong programme on a channel
The schedule is there, but it belongs to another channel. That is a match on the wrong id: the playlist gives the channel a guide id that, in the provider’s guide, belongs to a different channel, often a regional or timeshifted version of it (“+1” channels run the same schedule an hour later). The fix is in the playlist, and with an Xtream login or a provider’s M3U link that playlist is the provider’s to correct.
If the programme is right but at the wrong hour, every channel shifted by the same amount, it is a time zone problem rather than a match: guide times are wrong has the way to measure the offset.
How far ahead and how far back a guide goes
As far as the provider publishes. One or two days ahead is common, a week is generous. Backwards, a guide usually keeps the last day, and longer on channels with a catch-up archive, since a programme you want to watch from its start has to be in the guide to be found.
A player can only show what the file contains. If the grid ends tomorrow evening, the file ends there.
Size, data and battery
A full XMLTV guide for a large lineup is big: tens of megabytes compressed, several times that unpacked, with hundreds of thousands of programmes. Downloading it on mobile data every few hours adds up, and reading it takes a phone or TV box some seconds of work. That is why players refresh the guide on a schedule rather than every time you open the app, and why a sensible schedule waits for Wi-Fi and a charger.
Can I use a different guide?
Yes, if you have the address of another XMLTV guide that covers your channels with the same ids. The player matches whatever guide it is given against the playlist’s ids, so a guide built for another lineup will match few channels, or none. The provider’s own guide is the one built for its ids, which is why it is the first thing to fix when it is missing.
What the guide is for, beyond the grid
The guide is what makes three things in a player possible at all. Recording a programme to its end needs the programme’s end time; recording every episode of a series needs the guide to list the next ones; and watching a programme from its start needs to know when it started. Without a guide, a player can still record for a fixed length and play the channel live, but it cannot do any of those. How recording and catch-up work in Adless is on the recording page.
Adless reads the guide your provider publishes for your own playlist. It ships no channels, no playlists and no guide of its own.
Read next
- IPTV guide times are wrong: finding the offset When the TV guide lists programmes an hour or more off, the cause is a time zone, either on your device or in the guide. Measure the offset, read what it means, and fix the right side.
- M3U vs Xtream Codes: which login to use Your provider gave you an M3U link and an Xtream Codes login for the same account. What each one carries, where they differ in an IPTV player, and which to enter first.
- IPTV player vs IPTV service: what each one does An IPTV player is the app; an IPTV service is the subscription with the channels. What each side is responsible for, why the player comes with no channels, and who to ask when something breaks.