What the EPG does
Without a guide, a channel list is just names. You can see that a channel exists, but not whether it is currently showing the football or a shopping segment. The EPG turns that list into something you can plan around.
A working guide typically gives you programme titles and descriptions, start and end times, a grid you can scroll forward through, and — on players that support it — a reminder or a jump into catch-up. Ours runs 7 days ahead, which is a fairly standard window.
Where the data comes from
This is the part worth understanding, because it explains nearly every EPG complaint.
The programme data does not travel inside the video stream. It is a completely separate file, usually in a format called XMLTV, fetched independently by your player. So your IPTV setup is really doing two jobs at once: pulling video streams, and pulling a schedule document that describes them.
Those two things are then matched up. Each channel in your playlist carries an identifier — a tvg-id — and the guide file contains listings tagged with the same identifiers. The player joins them. When a channel shows no listings, it is almost always because those two identifiers did not match, not because the guide is broken.
Why the guide is empty when you first set up
An XMLTV file covering hundreds of channels for seven days is large. Downloading and indexing it takes time — on a modest device such as a Firestick, several minutes is entirely normal.
So an empty guide two minutes after setup is expected behaviour, not a fault. Let it finish. After the first load, players refresh it in the background and it is no longer noticeable.
Why coverage is uneven between channels
Guide data is compiled per channel, and not every channel has an equally good source. In practice:
- Major national channels almost always have a full seven days with descriptions.
- Smaller or regional channels may have partial listings, or titles without descriptions.
- Some niche channels may have none at all.
This is a property of the available source data rather than a setting anyone can change. No provider can invent listings for a channel nobody publishes a schedule for — and any provider claiming a complete guide for every channel is overstating it.
Getting the most out of your guide
- Let the first download finish before judging anything.
- Check the EPG option is switched on in your player's settings — some default to off.
- Hide groups you never watch. A guide covering 200 channels is far more usable than one covering 2,000.
- Choose a player with a good guide if live TV is your priority. TiviMate's grid is the benchmark on Android; see our player comparison.
- Set the correct time zone on the device. A guide that looks shifted by a few hours is nearly always a device clock problem.
If your guide is missing entirely or showing the wrong programmes, our EPG troubleshooting guide works through the causes in order.
What XMLTV and tvg-id actually look like
These two terms come up constantly in guide problems, and they are simpler than they sound.
XMLTV is just a file format for television schedules — a structured document listing channels and, under each, the programmes with their start and end times. It is a published standard rather than anything specific to IPTV, which is why the same guide file can be read by very different software.
A tvg-id is the label that ties the two halves together. Your playlist says "this channel is called tvg-id: bbcone.uk"; the guide file says "here are the programmes for bbcone.uk". The player matches the strings and draws the grid. When they do not match exactly — a different capitalisation, a suffix, a renamed source — the player has no way to know the two refer to the same channel, and that channel shows an empty row.
That is why a guide can be perfectly healthy overall while a handful of channels stay stubbornly blank. Our plain-English glossary of IPTV terms covers these and the others you will meet during setup.
Where your guide address comes from
How the guide reaches your player depends on how you logged in, and this catches people out when they switch apps.
With an Xtream Codes login, the guide usually arrives automatically: the player asks the provider’s system for both the channels and the schedule, so there is nothing separate to configure. With an M3U playlist, the guide is normally a second address you enter yourself in the player’s EPG settings.
So a setup that had a working guide can lose it entirely after moving to a different player, simply because the second address was never carried across. Our comparison of Xtream Codes and M3U explains the difference, and it is worth noting the guide address alongside your login when you record your details.
When the guide is shifted by hours
A guide that shows the right programmes at the wrong times is a different fault from an empty one, and it usually has a simple cause.
Schedule files carry times with a time-zone offset attached. Your player converts those into local time using the device clock and its own time-zone setting. If the device is set to the wrong zone, or is set to a fixed offset while the schedule assumes daylight saving, everything appears uniformly shifted.
Check the device clock and time zone first, then the player’s own EPG time-zone or offset setting if it has one. A uniform shift across every channel points at your settings; a shift on one channel only points at that channel’s source data, which is not something you can correct locally.
What the guide can and cannot tell you
Worth being straightforward about, because expectations here cause avoidable frustration.
A schedule is a plan published in advance, not a live description of what is on screen. Broadcasters change schedules at short notice, live events overrun, and a guide compiled hours or days earlier cannot know about any of it. That is true of broadcast television as well; it is simply more visible when you are comparing a grid against a stream.
Guide data also says nothing about whether a channel is working. A populated row for a channel that will not play tells you the schedule was fetched successfully and nothing more — those are two independent systems. If channels are missing rather than merely unlisted, our guide on when a channel disappears from your list covers that instead.
Frequently asked questions
What does EPG stand for?
Electronic Programme Guide. It is the on-screen television schedule showing what is on now, what is next, and what is coming over the following days.
Why does my IPTV guide show no programmes?
Usually one of three reasons: the guide is still downloading on first run, the EPG option is switched off in your player, or the channel identifiers in your playlist do not match those in the guide file. The first is by far the most common.
How far ahead does an IPTV EPG go?
Typically around seven days, which is what ManisIPTV provides. The exact window depends on how much data the source publishes for each channel.
Why do some channels have no listings at all?
Guide data is compiled per channel and not every channel has a published schedule source. Major national channels usually have full listings; smaller or niche channels sometimes have partial data or none.
What is XMLTV?
A standard file format for television schedules, listing channels and the programmes under each with their start and end times. Your player downloads it separately from the video and matches it to your channel list.
What is a tvg-id?
The label that links a channel in your playlist to its listings in the guide file. If the two strings do not match exactly, the player cannot tell they refer to the same channel and that channel shows an empty row.
Why is my IPTV guide showing the wrong times?
Usually the device clock or time zone. Schedules carry a time-zone offset and the player converts it to local time, so a wrong setting shifts everything uniformly. A shift on one channel only comes from that channel’s source data instead.
Related articles
Ready to try it?
ManisIPTV plans start at €20 for one month and include the full channel line-up, the on-demand library and the 7-day guide, with setup help for your exact device. If you would rather see it working first, ask for the 24-hour free trial.