IPTV Program Guide (EPG) Not Showing? How to Fix It
An empty or outdated program guide doesn't mean your channels are broken. It's almost always a sync or cache issue, and it's quick to fix.
What the EPG actually is
EPG stands for Electronic Program Guide. The schedule data showing what's currently airing and what's next on each channel. It's separate from the video stream itself, which is why channels can play perfectly fine even when the guide is empty.
Step-by-step fix
- Refresh the playlist and EPG separately. Most apps have two different refresh actions. Refreshing just the channel list doesn't always pull new guide data. Check your app's settings for a dedicated "Refresh EPG" or "Update Guide" option.
- Check your device's date, time, and timezone. An incorrect clock can shift the whole guide by hours or make it look empty. Set these to automatic, then restart the app.
- Clear the app's cache. On Android TV and Firestick, clearing cache (Settings → Apps → [Player App] → Clear Cache) and restarting often rebuilds a stuck guide.
- Test a different channel. Not every channel carries full guide data. If most channels show a guide but a few don't, it's likely those specific channel records, not your setup.
- Try another player app. If the guide works in a second app with the same subscription, the issue is with the first app's settings, not your service.
If you're using TiviMate specifically
TiviMate is one of the most common apps people report EPG problems on, but the detail that gets missed is that TiviMate is just the player displaying guide data, not the source of it. If the guide is empty, the data either isn't being sent by your provider or isn't synced correctly in TiviMate's settings. It's rarely a bug in TiviMate itself.
Where to check, specifically:
- Settings → Playlists → [your playlist] → EPG source. Confirm an EPG URL is actually set. Some setups default to "none" if it wasn't added during initial setup.
- Remove and re-add the EPG source. This forces a full re-sync rather than relying on a partial cached version.
- Check "EPG duration" under playlist settings. If it's set very low, you'll only see a sliver of guide data and it can look broken when it isn't.
- Confirm the EPG URL matches what your provider gave you exactly. A typo or outdated link is one of the most common causes of a guide that loads the channel list fine but shows nothing for the schedule.
If you're using IPTV Smarters Pro specifically
Smarters Pro handles EPG a bit differently from TiviMate, and the fix lives in a different menu, so it's worth covering separately rather than assuming the same steps apply.
- Settings → Playlist Settings → EPG. Confirm the EPG is actually enabled for your playlist, it's a toggle that can get switched off during setup without you noticing.
- Pull down to refresh on the guide screen itself. Unlike TiviMate's separate refresh action, Smarters Pro often needs a manual pull-to-refresh gesture directly on the EPG tab to force a re-fetch.
- Delete and re-add the playlist as a last resort. If the EPG still won't populate, removing the playlist entirely and re-adding it with the same credentials forces a completely fresh sync, more reliable than refreshing an already-broken cache.
Built-in EPG vs a separate XMLTV URL
Guide data can come from one of two places, and mixing them up is a common source of confusion. Most providers, including TruWave TV, deliver EPG data built directly into the Xtream Codes login, no extra URL needed. Some setups instead rely on a separate XMLTV link you add manually in your app's settings. If you've added a third-party XMLTV URL on top of a provider that already includes its own guide data, the two can conflict or overwrite each other, sometimes showing stale or duplicate listings. If your guide looked fine and then broke after adding an EPG URL you found online, removing that manual entry and relying on the provider's built-in data is usually the fix.
Guide shows data, but the times are wrong
This is a different symptom from a totally empty guide, and it's almost always a timezone mismatch rather than missing data. If your device's timezone is set incorrectly, or set to automatic in a region with unreliable timezone detection, the guide can display what looks like a full schedule that's simply shifted by a few hours. Double-check your device's timezone setting against your actual location rather than assuming it's correct just because it's on "automatic."
Still showing a blank guide after these steps? Message TruWave TV on WhatsApp with your app name and device, and we'll check it with you directly.
Frequently asked questions
What is an EPG in IPTV?
EPG stands for Electronic Program Guide. It's the schedule data that shows what's currently playing and what's coming up next on each channel.
Why is my channel guide empty?
Usually a cache issue, an unsynced EPG source, or a channel that simply doesn't have guide data attached to it. Refreshing the playlist and EPG in your app's settings fixes most cases.
Does an empty guide mean my channels won't play?
No. The guide is just schedule information. Channels can stream fine even if the program guide data is temporarily missing or outdated.
Is TiviMate EPG not working TiviMate's fault or the provider's?
Almost always the provider or EPG source, not TiviMate itself. TiviMate is just the player displaying guide data it's given. If that data isn't being sent correctly, the app has nothing to show, regardless of how it's configured.
Why does my guide show the wrong times instead of being empty?
This is usually a timezone mismatch, not missing data. Check your device's timezone setting against your actual location rather than assuming "automatic" has it right.
Should I add a separate XMLTV URL if my provider already includes EPG data?
Generally no. Adding a third-party XMLTV link on top of a provider's built-in guide data can cause conflicts or stale listings. If your guide worked before you added one, removing it usually fixes the issue.