IPTV EPG: How the Programme Guide Works
Quick Answer
The IPTV schedule, or EPG (electronic programme guide), is the on-screen listing of what's on now and next on each channel. The data comes separately from the video stream, usually from your subscription or an XMLTV guide link, and your player app matches it to channels. A channel with no guide data still plays normally. Missing or shifted listings are usually fixed by refreshing the EPG or correcting the app's time-zone offset.
Key Points
- EPG data is separate from the video stream; a channel can play with no guide.
- Xtream Codes logins usually load the guide automatically; M3U setups may need an XMLTV URL.
- Grid guides (like TiviMate) show many channels at once; list guides show one at a time.
- Listings an hour out are almost always a time-zone or offset setting.
- Refreshing or clearing the EPG cache fixes most stale guides.
The programme guide is what turns a long channel list into something you can browse by time. Knowing where its data comes from explains most guide problems.
Where IPTV Guide Data Comes From
Guide data is published in a standard format called XMLTV: a file listing programmes, start and end times and channel IDs. With an Xtream Codes login, most apps fetch this automatically from the same server. With an M3U playlist, the guide may be a separate URL you add in the app's settings.
The app then matches each programme listing to a channel using an ID in the playlist. If a channel's ID has no match, it plays normally but shows an empty schedule.
Common EPG Problems and Fixes
| Problem | Likely cause | Fix |
|---|---|---|
| No guide at all | Guide not loaded or no XMLTV URL | Refresh the EPG, or add the guide URL for M3U setups |
| Some channels empty | Channel not matched to guide data | Normal for some channels; ask your provider if it matters |
| Times shifted by an hour or more | Time-zone or EPG offset setting | Adjust the time offset in the app's EPG settings |
| Guide out of date | Cached data not refreshed | Clear the EPG cache and reload |
How Different Apps Show the Guide
TiviMate is built around a grid: rows of channels, columns of time, like a traditional TV guide. IPTV Smarters Pro and most phone apps show a now and next overlay and a per-channel list. The data is the same; the layout decides how quickly you can scan what's on.
Getting the Most From the Guide
- Set guide refresh to happen automatically, such as daily.
- Use favourites so the grid only shows channels you watch.
- Use catch-up from the guide where the channel and subscription support it.
Frequently Asked Questions
Can I fix a missing guide myself?
Often, yes. Refreshing the EPG, adding the correct XMLTV URL or adjusting the time offset fixes most cases. A channel with no guide data at all can only be fixed by the provider.
Why is my guide an hour off?
Usually a time-zone mismatch. Change the EPG time offset in your player's settings.
Does the guide use extra bandwidth?
Very little. Guide files are small compared with video streams, though large guides can take a moment to load.
The TiviMate guide shows how a grid-style guide works in practice, and the setup guide covers where to enter your login so the guide can load.
