Troubleshooting guide · 2026
IPTV EPG Guide: Understanding and Fixing Your TV Listings
Updated August 5, 2026 · By Toronto’s Best IPTV Editorial Team
An IPTV picture can be perfect while the on-screen guide is empty, shifted three hours, or showing last week’s schedule. That is because the guide is a separate data feed from the video. This guide explains how EPG data works and gives you an ordered way to fix the common failures.
Short answer
An EPG is the electronic program guide: a separate XMLTV data file your app downloads and matches to channels. Blank rows, wrong shows and time-shifted listings almost always come from channel-ID mismatches, stale caches or a timezone setting — not from the video stream itself. Refresh, check timezone, then contact support.
What the EPG actually is
When you open the guide, your app is not asking a channel what is playing. It is reading a file — usually XMLTV format — that lists programmes, start and end times in UTC, and a channel identifier for each entry. The app then tries to match those identifiers against the channels in your line-up and draws the grid.
Two independent things must both work: the stream must play, and the guide entry must match. That is why you can watch a channel perfectly while its row in the guide says “No information”. It also means most guide problems are fixed in settings rather than by changing plans or devices.
Symptom-to-cause table
| What you see | Most likely cause | First thing to try |
|---|---|---|
| Guide completely empty on every channel | The guide file never downloaded, or the app’s EPG cache is corrupt | Force an EPG refresh, then clear the app cache and reopen |
| Empty rows on a handful of channels only | Those channels have no matching XMLTV identifier | Refresh once; if still blank, report the exact channel names to support |
| Everything shifted by a whole number of hours | Device timezone or an app time-shift offset | Set automatic date and time, confirm region, reset any manual EPG offset to zero |
| Listings are yesterday’s schedule | Stale cache — the refresh has not run since the source updated | Manual refresh, then restart the app so it re-parses |
| Guide loads very slowly on start-up | Large guide file on low-memory hardware | Reduce guide days if your app allows it, or move to a box with more RAM |
| Catch-up entries greyed out | That channel’s source does not provide archive data | Check a different channel to confirm the app itself is fine |
Step-by-step fixes on common devices
Firestick and Android TV apps
- Open the app settings and run the manual EPG or “update” action.
- Close the app fully from recent apps and reopen it so the cache re-parses.
- In device settings, enable automatic date and time and confirm the timezone.
- If the guide is still empty, clear the app’s cache — not its data — and retry.
Formuler and MAG set-top boxes
- Reload the portal or profile so the box re-requests the guide file.
- Check the EPG time-shift value in settings and set it to zero unless you need it.
- Reboot from the menu rather than pulling power, so settings write cleanly.
Smart TV apps, phones and tablets
- Update the app to the current version — guide parsing changes between builds.
- Confirm the phone or TV is on the right region and automatic time.
- Reload the profile; on phones see our phone and tablet setup guide.
Detailed per-device walkthroughs live in our setup guides and on the how-to hub.
Network conditions that look like EPG faults
A guide file can be several megabytes. On a weak Wi-Fi link the download times out part-way and the app shows a partial grid, which reads like missing channels. If your guide is inconsistent between reloads, treat it as a network issue first: move to the 5 GHz band, put a mesh node in the same room, or run Ethernet to the TV.
Condo buildings in dense areas are especially prone to this — we cover the practicalities in our Downtown Toronto and Bay Street guide.
When to contact us instead of troubleshooting further
If you have refreshed, corrected the timezone and confirmed a stable connection and specific channels still have no listings, the data is missing upstream and there is nothing left to change on your side. Send us the exact channel names and your device model and we will check what the source provides. We cannot promise every channel carries full guide data, but we can tell you what we see.
Frequently asked questions
What does EPG mean on an IPTV app?
EPG stands for Electronic Program Guide — the grid of what is playing now and next on each channel. The guide is a separate data file from the video streams, usually XMLTV, and your app downloads and caches it on a schedule set by the app or the source.
Why is my EPG blank on some channels?
Guide data is keyed to a channel identifier. If a channel has no matching entry in the XMLTV file, or the identifier changed upstream, the row stays empty even though the video plays fine. Refreshing the guide usually helps; if it does not, the channel likely has no listing data at that source.
Why is my guide off by a few hours?
Almost always a timezone mismatch. The XMLTV file carries UTC offsets and your app applies your device timezone on top. Set the device to the correct region, turn on automatic date and time, and check the app’s own EPG timezone or time-shift setting before assuming the data is wrong.
How often should the EPG refresh?
Once every 24 hours is typical and enough for most viewers. Refreshing constantly does not add listings and mainly slows the app’s start-up while it re-parses a large file. Force a manual refresh only when listings look stale or a channel line-up has changed.
Which devices handle EPG best?
Set-top boxes with dedicated IPTV firmware, such as Formuler or MAG models, generally parse large guide files faster than budget sticks because they have more memory to work with. Firestick, Android TV and smart TV apps all display EPG data fine, but very large guide files can take longer to load on entry-level hardware.
Still seeing blank listings? Send us the channel names and we will look into it.