By the XtreamCube team · Published · Updated · 5 min read

On this page
  1. How the guide reaches your player
  2. Fix 1: no guide at all
  3. Fix 2: the guide shows the wrong times
  4. Fix 3: some channels have a guide, others do not
  5. Fix 4: the guide stops after a day or two
  6. Fix 5: the guide is slow and the player feels sluggish
  7. Guide and catch-up go together
  8. Players that handle the guide best
  9. Test it before you pay
  10. Questions people ask

IPTV TV Guide (EPG) Explained: Set It Up and Fix the Common Problems

The EPG is the programme guide: the grid that shows what is on now, what is on next and, on lines with catch-up, what you can replay. When it is missing or shows the wrong times, the channels still play, but the experience feels broken. Nearly every guide problem comes down to one of five causes, and each one has a quick fix. This page explains how the guide reaches your player and walks through those fixes.

How the guide reaches your player

EPG stands for Electronic Programme Guide. Your line delivers two separate things: the channels themselves and a guide file, usually in a format called XMLTV, which lists every programme with a start and end time. The player matches the two using an identifier attached to each channel. If the guide never arrives, or the identifiers do not match, the grid stays empty.

How the guide arrives depends on how you added your line:

  • Xtream Codes login (server, username, password). The player asks the server for the guide automatically. In most cases you do nothing.
  • M3U playlist link. The playlist contains channels only. Many players fetch the guide by themselves when the playlist was produced by an Xtream-style panel, but some need you to paste a separate guide address.
  • MAG-style portal (MAC address). The box downloads the guide from the portal. The settings live in the box's own menus.

Not sure which one you have? Our Xtream and M3U converter reads both shapes and shows the three Xtream fields hidden inside an M3U link, all inside your browser.

If you have a choice, log in with the three Xtream fields rather than the M3U link. The guide, catch-up and categories then come straight from the server, and most guide problems never appear.

Fix 1: no guide at all

The grid is empty on every channel.

  1. Give it time on first load. A full guide covers thousands of channels for several days and can take a few minutes to download and process, especially on a streaming stick. Leave the player open for five minutes.
  2. Check how the line was added. If you used an M3U link, switch to the Xtream login, or add the guide address in the player's EPG settings. For an Xtream-style panel the guide address is the server followed by /xmltv.php?username=YOURNAME&password=YOURPASS.
  3. Force an update. Every serious player has an "update EPG" or "refresh guide" option. In TiviMate it sits under the EPG settings. Run it once after any change.
  4. Clear the player's cache. On Android devices, Settings, Apps, the player, then Clear cache (not Clear data, which removes your playlists).

Fix 2: the guide shows the wrong times

Programmes appear but everything is shifted by one or more hours. This is the most common guide complaint and almost never a fault in the guide itself.

  • Set the device's time zone by name, not by offset. A device set to a fixed offset such as GMT+1 does not follow summer time, so the guide jumps by an hour twice a year.
  • Check the player's time shift setting. Most players have an "EPG time shift" or "time offset" option. It should normally be zero. A value left over from an old provider is a frequent cause.
  • Check the date and time sync. A box with an empty clock battery or network time switched off can drift by minutes or hours.

Our country setup guides, for example Canada with its six time zones, show the right settings for each region.

Fix 3: some channels have a guide, others do not

This is a matching problem. The guide contains listings for a channel, but the identifier on the channel does not match the one in the guide.

  • Update the guide first. New channels are often added to the playlist before their listing appears.
  • Use the player's manual matching. Some players, TiviMate among them, let you open a channel's settings and pick its guide entry by hand. You only do this once per channel.
  • Accept that some channels have no listing. Event channels, pop-up sports feeds and some radio stations have no fixed schedule, so there is nothing to show.

Fix 4: the guide stops after a day or two

The grid fills for today and then goes blank further ahead. The player is keeping fewer days than the guide provides, or it stopped updating. Set the automatic update to once a day and, if the option exists, increase the number of days kept. If the player runs on a stick with little storage, keep the days low: a lighter guide loads faster.

Fix 5: the guide is slow and the player feels sluggish

A full guide is a large file, and older sticks struggle to process it. Three things help:

  • Hide channel groups you never watch, so the player loads fewer listings.
  • Reduce the number of days kept to two or three.
  • Move to a device with more memory. A Formuler box or an NVIDIA Shield handles a full guide without hesitation.

Guide and catch-up go together

On lines that offer catch-up, the guide is how you reach it: you scroll back in the grid and choose a programme that has already aired. If the guide is missing or shifted, catch-up looks broken too, even though the recordings are there. Fix the guide first and catch-up usually returns with it.

Players that handle the guide best

Some players are much better at guides than others. TiviMate is the reference on Android TV and Fire TV for its grid and manual matching. On Samsung and LG TVs, IBO Player shows a guide grid. On MAG-style boxes the portal provides the guide, and on Formuler the MYTVOnline 3 app does. Our comparison of IPTV players covers each one, including what they do poorly.

Test it before you pay

XtreamCube lines include a TV guide and catch-up on the channels that support them. The 24-hour free trial needs no card, so you can check that the guide loads with the right times on your own device before deciding. If anything looks off, support is there 24/7 by chat, email and WhatsApp.

Questions people ask

What does EPG mean in IPTV?

Electronic Programme Guide. It is the schedule that tells the player what is showing on each channel and when, and it powers the guide grid and catch-up.

Why does my IPTV show channels but no guide?

Usually because the line was added as an M3U link without a guide address. Log in with the Xtream fields instead, or paste the guide address into the player's EPG settings, then force an update.

Why is my IPTV guide one hour off?

The device is set to a fixed time offset instead of a named time zone, or the player has a time shift value left over. Set the zone by name and put the player's EPG time shift back to zero.

How often does the TV guide update?

The guide on the server updates daily. Your player only shows the new data after it refreshes, so set its automatic update to once a day.

Does a VPN affect the TV guide?

It can make the guide load more slowly, and some VPNs change the time zone the device believes it is in. If times shift only when the VPN is on, set the time zone manually by name.