IPTV EPG: How the Programme Guide Works and How to Fix It
Quick Answer
An IPTV schedule or EPG (electronic programme guide) is a separate data feed, usually in XMLTV format, that lists what's on each channel. The player matches each channel to guide data by an ID (tvg-id in M3U playlists). An empty guide usually means the EPG hasn't been loaded or refreshed, or a channel's ID doesn't match the guide data. Times shifted by an hour or more usually mean a time-zone setting.
Key Points
- Guide data arrives separately from the video.
- With Xtream Codes logins it is usually loaded automatically.
- With M3U links you may need to add an XMLTV address.
- Empty guide for one channel = matching issue; empty for all = not loaded.
- Wrong times = time-zone or EPG offset setting.
A channel can play perfectly and still show "No information" in the guide. That is because the picture and the programme listings come from two different places.
Where Guide Data Comes From
Guide data is a large file of programme listings, normally in XMLTV format, published by the service or a guide provider. With an Xtream Codes login, the app usually fetches it automatically. With an M3U playlist, the app needs the XMLTV address, sometimes embedded in the playlist header and sometimes entered by hand.
Each channel in the playlist has a tvg-id. The player looks for that same ID in the guide file; if it finds it, the listings appear.
Fixing Common Guide Problems
| Problem | Likely cause | Fix |
|---|---|---|
| Guide empty for every channel | EPG not loaded yet | Refresh or update EPG in the app settings and wait |
| Guide empty for some channels | No matching guide ID | Normal for some channels; report specific ones to your provider |
| Times off by an hour or more | Time zone or offset | Check the device time zone and the app's EPG time-shift setting |
| Guide stops after a day or two | Not refreshing | Set an automatic update interval |
| Guide very slow to load | Huge guide file | Hide unused channel groups so less data is processed |
How Apps Show the Guide
TiviMate uses a TV-style grid with many channels and time slots at once. IPTV Smarters Pro shows a guide view plus now-and-next information beside each channel. Kodi has a full grid under TV > Guide. If browsing by schedule matters to you, the guide layout is a good reason to choose one player over another.
Using the Guide Well
Mark favourites so the guide opens on channels you actually watch, use reminders where the app supports them, and check whether catch-up is available for a channel; it depends on the service as well as the app.
Frequently Asked Questions
Why does a channel play with no guide?
Its ID doesn't match any entry in the guide data. The stream is fine; only the listings are missing.
How often should the guide update?
Once a day is enough for most people. Listings usually cover several days ahead.
For other setup issues, see the setup guide's troubleshooting section.