Skip to content
IPTV Subscription 8K - 8K TV Subscription

TV guide

How to add a TV guide (EPG) to your IPTV app

Adding a TV guide takes a minute once you know which of two situations you’re in. With an Xtream Codes login, the guide usually comes with it and only needs updating. With an M3U playlist, you normally add the guide address yourself. Here’s both, plus the settings that keep the guide accurate.

Updated · 2 min read

Also available in Dansk · Norsk · Svenska

With an Xtream Codes login

Most apps load the guide automatically from your server.

  1. Sign in and let the channel list load completely.
  2. Find the guide or EPG update option. It’s often in the app’s settings, or in the TV guide screen’s menu, and may be called Update EPG, Refresh guide or Load EPG.
  3. Run it once and wait until it finishes.
  4. Open the guide view and check a few channels.

If the guide stays empty, you can add the address manually as for M3U below, using your server’s xmltv.php address. Xtream Codes to M3U shows how to write it.

With an M3U playlist

  1. Find your guide address. Look in your provider’s message, or in the first line of the playlist for x-tvg-url or url-tvg. See EPG URL for where else it can be.
  2. Open the playlist’s settings in your app and look for EPG URL, XMLTV URL, EPG source or TV guide source. Some apps keep guide sources in a separate section, where you can add several.
  3. Paste the address, save, then run a manual guide update.
  4. Check the guide on a few popular channels.
AppWhere to look
TiviMateSettings, then the EPG section, to add an EPG source; see TiviMate EPG
IPTV SmartersLoads with Xtream Codes; refresh from the settings or the guide screen; see IPTV Smarters EPG
Kodi (PVR IPTV Simple Client)The add-on’s settings, under EPG, as an XMLTV address; see Kodi IPTV EPG
Smart IPTVChosen on the playlist upload page, where you can let it detect the guide from your playlist
VLCNo IPTV programme guide

Apps change their menus between versions, so the exact wording may differ slightly on your device.

Settings that keep the guide accurate

  • Update interval: set the guide to refresh automatically every day, or at every start-up if the app offers it.
  • Days to keep: two or three days is a good balance between usefulness and speed.
  • Time offset: leave it at zero unless listings are consistently early or late. See EPG wrong time.

If the guide is still empty

Go to TV guide not loading for an empty guide, or “EPG not available” for some channels when only some channels are blank.

FAQ

Adding a guide questions

How long does the TV guide take to load?

From a few seconds to a few minutes, depending on how many channels and days it covers and how fast your device is. Leave the app open until the update finishes the first time.

How many days of guide should I load?

Two to three days is plenty for most people and keeps the app fast. Longer guides take more memory, which matters on Smart TVs and older sticks.

Why does VLC not show a TV guide?

VLC plays streams but doesn’t display XMLTV programme guides for IPTV playlists. Use a dedicated IPTV player if you want a guide.

Start watching on your own screen

Plans from £5.83 a month on the 12-month plan, no contract and no auto-renewal. Test it first with a 24-hour free trial.