Skip to content

How to fix EPG not loading on any IPTV app

Clear cached guide data, correct the EPG URL, and fix time offsets so your IPTV app loads full program schedules.

Updated November 14, 2026 4 min read


On this page

The Electronic Program Guide (EPG) fills your TV guide with channel schedules, show descriptions, episode details, and channel logos. When the EPG does not load, you are left with an empty grid that shows No Information, No Data Available, or blank channel banners.

If you are not familiar with how program guides work, read what an EPG is to understand how XMLTV files and EPG URLs sync with your player.

This guide covers universal, step-by-step fixes for TiviMate, IPTV Smarters, Perfect Player, GSE Smart IPTV, and Kodi. The steps work on any IPTV app.

Why the EPG does not load

An EPG failure usually happens for one of five reasons:

  1. Expired or outdated cache. The app tries to read cached guide data that has passed its expiration window.
  2. Incorrect EPG source URL. There is a typo in the XMLTV URL parameters.
  3. Mismatched channel IDs. The channel names in your playlist do not match the ID tags in the EPG source file.
  4. Time zone mismatch. Your device time or the app offset setting does not match the clock of the EPG provider.
  5. ISP or firewall blocking. Your Internet Service Provider is blocking the port or the server that hosts the XMLTV file.

Universal fixes for EPG loading issues

Follow these steps in order to restore the program guide on any platform.

1. Clear the EPG cache and the app cache

Cache files often corrupt the internal database that the app uses to store guide schedules.

  • In the app: Open the IPTV app settings, for example in TiviMate or GSE. Find EPG Settings, select Clear EPG, then select Update EPG.
  • On the device: Open the settings of your streaming device (Fire TV Stick, Chromecast, or Android TV), then go to Apps > Your IPTV App > Clear Cache. Do not select Clear Data unless you want to enter your login details again.

2. Check the EPG source URL

If you added an external XMLTV source link by hand, check the web address for small syntax errors.

  1. Check for typos. Make sure there are no accidental spaces, no trailing slashes, and no missing colons in the http:// or https:// part of the address.
  2. Check the file extension. Most standalone EPG sources end in .xml or .xml.gz. If your source is compressed (.gz), check that your player supports compressed guide files.

For app-specific setup with custom EPG URLs, read the dedicated guides:

3. Assign the EPG source to the playlist

If you have more than one playlist, or you added an external EPG link next to an Xtream Codes login, the player may not know which EPG source belongs to which channel list.

  1. Open Settings > Playlists and select your active IPTV playlist.
  2. Find the EPG Sources or Main EPG option. Make sure your primary EPG link or Xtream Codes guide is switched to Default or Active.
  3. If only some channels show No Info, open the channel options menu, select Assign EPG or Change EPG, then search for the matching channel ID by hand.

4. Adjust the EPG time shift or time zone offset

If the guide shows program schedules that are shifted by several hours, for example when prime-time shows appear at 3:00 AM, the guide data is loading but the time offset is wrong.

  1. Open the system settings on your streaming device. Make sure Time Zone and Date & Time are set to automatic.
  2. Open the EPG settings in your app and find EPG Time Shift or Time Offset.
  3. Move the slider in 1-hour steps, for example +2.00 or -5.00, until the live show matches the time on your clock.

5. Check for ISP blocks and router firewalls

Some ISPs block access to third-party EPG servers or XML web hosts.

  • Test on a mobile hotspot. Disconnect the device from your home Wi-Fi, connect it to the hotspot on your phone, and select Update EPG in the app settings.
  • Use a VPN. If the guide updates immediately over mobile data, turn on a VPN on your home network to bypass the ISP block on EPG servers.

Frequently asked questions

How often should the EPG update automatically?

Most IPTV apps update EPG data automatically every 24 to 48 hours. Updating more often, for example every hour, can freeze the app or trigger temporary rate-limit blocks from the EPG host server.

Why does an Xtream Codes login show channels but no EPG?

When you connect through Xtream Codes, the player fetches channel streams and EPG data separately. If the channels work and the guide stays blank, the EPG server module of your provider may be under maintenance, or the internal database cache in your app needs to be cleared and refreshed.

Yes. Most advanced IPTV players, such as TiviMate, Perfect Player, GSE, and Kodi, let you add custom external XMLTV EPG links next to the main playlist of your provider to fill in missing program information.

More in Troubleshooting

Still stuck?

Our support team can help you set up your device or fix a problem.

Contact support