Without a programme guide, live television is a list of channel names and nothing else. With one, you get what is on now, what is on next, and in many players the ability to set a reminder. It is usually a two-minute job, and when it goes wrong the reason is almost always the same.
What an EPG is
An electronic programme guide is a separate file, normally in a format called XMLTV, listing programmes with their start times, end times, titles and descriptions. It is delivered as its own URL, independent of your channel list, and your player downloads it and overlays it onto the channels it already has.
That independence is the key fact. The channel list and the guide are two different files from two different places, and the player has to match them up.
Adding one
Ask your provider for the EPG address — it is usually an .xml or .xml.gz URL, and on an Xtream Codes setup it is often generated automatically from the same server.
In your player, find the settings section dealing with EPG, TV guide or programme data. Paste the URL in and save. Most players then need a manual refresh the first time, after which they update on a schedule — commonly every twelve or twenty-four hours.
Give the first download time. A guide covering thousands of channels for the next week is a large file, and on a slow device the parsing step alone can take a minute or two.
The failure that catches everyone
You add the URL, the download succeeds, and the guide is still empty. Nothing is broken: the player cannot work out which guide entry belongs to which channel.
Matching is done by an identifier. Each channel in your playlist carries a tvg-id, and each channel in the guide carries its own id. If the two do not match exactly, the player has no way to connect them and shows nothing — case and punctuation included.
Three fixes, in order of effort:
- Ask your provider for the matching EPG. A guide produced for your playlist will already have the right identifiers. A generic guide found elsewhere almost certainly will not.
- Use the player’s manual mapping. Better apps let you tell them which guide channel belongs to which playlist channel. Tedious across a whole list, but fine for the dozen channels you actually watch.
- Check the timezone. If the guide appears but every programme is a few hours out, the player is interpreting the times in the wrong zone. There is almost always a timezone or offset setting nearby.
Keeping it fast
A full guide is a heavy file for a cheap streaming stick. If your device is sluggish after adding one, look for a setting limiting how many days are stored — reducing it from seven days to two or three cuts the memory needed substantially and most people never notice the difference.
Some players also offer a compressed .gz version of the same guide. Use it if it is offered: it downloads faster and decompresses on the device.
When there is genuinely no guide
Not every channel has programme data, particularly smaller or regional ones. A guide that is populated for the main channels and blank for a handful of others is normal and not a fault.