IPTV EPG: what it is, and why yours is empty
The programme guide is the difference between browsing television and guessing at it. When it is missing, the cause is nearly always one of three things.
What an EPG is
EPG stands for Electronic Programme Guide — the schedule your television shows when you press the guide button: what is on now, what is next, and often the days ahead. On classic television it arrives inside the broadcast signal. On IPTV there is no such signal, so the guide must be delivered separately.
Where it comes from
Two routes, and they behave differently:
- Through Xtream Codes. Your player asks the provider's server directly for the current and next programme on a channel. Nothing to configure — if the provider has the data, you see it.
- Through an XMLTV file. A separate file, sometimes several megabytes, listing every programme on every channel. Your player downloads it and matches each channel to its entry.
The matching is done by an identifier: tvg-id in the playlist must equal the channel id in the guide. When those two disagree, the guide is technically present and practically invisible.
The three reasons yours is empty
1. Your playlist is a plain M3U
A basic M3U carries no tvg-id, so nothing can be matched. Ask your provider for the m3u_plus link, or better, use your Xtream Codes credentials — the guide then comes straight from the server.
2. Your provider has no guide for those channels
Common on small or regional channels, and on films and series where a guide makes no sense anyway. Nothing on your side will create data that does not exist. Test a large national channel: if that one has a guide and a small one does not, the provider simply lacks the data.
3. The identifiers do not match
The playlist says tvg-id="bbc1.uk" while the guide calls it BBC.One.uk. Everything is there, nothing lines up. This is the provider's job to fix — report it, since they are the only ones who can align the two.
When the guide is an hour or two off
A guide carries times in a particular time zone. If your device's time zone, the guide's offset, or daylight saving disagree, every programme appears shifted by a whole number of hours.
Check the device time zone first, especially on a cheap Android box: they often ship set to UTC and never get corrected. That single setting explains most “my guide is one hour late” reports.
How much guide do you actually need?
Seven days of full grid sounds impressive and is rarely used. What people use, every evening, is now and next on the channel they are watching — enough to know whether to stay or to move on. That is what Aquar Player shows over the video, taken from your provider through the API. If your subscription carries a deeper guide, it is there for the same channels; if it carries none, no player can invent it.
A quick checklist
- Are you connected with Xtream credentials rather than a plain M3U link?
- Does a major national channel show a guide? If yes, the setup works and the gaps are the provider's data.
- Is the device time zone correct?
- Still nothing on every channel? Ask the provider whether their package includes EPG at all — some cheap packages simply do not.