Guides

IPTV EPG Explained: How the TV Guide Works

IPTV EPG TV guide explained
By · Updated · How we create our guides (AI use)

The IPTV EPG (electronic programme guide) is the TV guide grid in your player app that shows what is on now and next on each channel. It comes from a separate data feed, usually in XMLTV format, that the app matches to your channel list. An empty or wrong EPG does not stop channels from playing. This page explains how the guide works. If yours is empty or stuck, follow our step-by-step IPTV EPG not working fixes.

IPTV EPG TV guide explained

Try it on your own TV first: 24-hour free trial, no card needed. Get the free trial

Part of our guide to what IPTV is and how it works, and our complete IPTV UAE guide.

On this page

What is an IPTV EPG?

An IPTV EPG is a schedule of programmes for each channel, shown in a grid inside your app. It tells you the title, start time and end time of each show, and often a short description.

The EPG is separate from the channels themselves. Your channels come from your login or playlist. The guide comes from a schedule file that the app downloads and lines up with those channels. That is why a channel can play perfectly while its guide is blank.

A working EPG makes IPTV much easier to use. You can see what is on tonight, plan a match, and, on supported channels, go back to replay a show you missed.

How does the IPTV EPG work?

The app downloads a schedule file, reads each programme’s channel ID and times, and places it on the matching channel in the grid. Most IPTV guides use XMLTV, an XML format for TV listings. Its DTD, version 0.5 from 2002, was written by Ed Avis and Gottfried Szing.

In XMLTV, each programme has a channel ID and a start time, and usually a stop time. According to the XMLTV DTD, times are written as year, month, day, hour, minute and second, with an optional time zone such as +0300. If no zone is given, Universal Time is assumed.

EPG part What it does What goes wrong
Channel ID Links a programme to a channel in your list No match, so that channel’s guide is empty
Start and stop times Place the show on the timeline Wrong time zone shifts every show
Title and description Tell you what the show is Rarely a problem
Download The app fetches the file on a schedule Not refreshed, so the guide runs out

With an Xtream Codes login, the app usually fetches the guide automatically. With an M3U playlist, some apps need a separate EPG link.

What does an XMLTV guide file look like?

An XMLTV file has one root element called tv. Inside it sit channel elements and programme elements, as set out in the XMLTV DTD.

Each channel needs an id and at least one display-name. Each programme needs a start time, a channel and at least one title. The stop time, description, category and episode number are optional.

<tv>
  <channel id='news.ae'>
    <display-name lang='en'>Example News</display-name>
  </channel>
  <programme start='20261107210000 +0400' stop='20261107220000 +0400' channel='news.ae'>
    <title lang='en'>Evening Bulletin</title>
  </programme>
</tv>

This made-up example puts a one-hour show at 9 pm UAE time on 7 November 2026. The same slot in Universal Time is 20261107170000 +0000. Both describe the same moment, so a correct app shows 9 pm on a device set to Dubai time.

XMLTV element Required? What you see in the app
tv Yes, once per file Nothing directly; it wraps the whole guide
channel id Yes Nothing; it is used for matching
display-name Yes, at least one The channel name in the guide
programme start Yes Where the show begins on the grid
programme stop No Where the show ends
title Yes, at least one The show name
desc, category, episode-num No Description, genre and episode number
icon No A channel logo or show image

How does an M3U playlist link to the EPG?

In an M3U playlist, each channel line can carry a tvg-id. That value must equal the channel id in the XMLTV file, or the app cannot match the guide. The TVIP M3U reference describes tvg-id as the channel’s id in XMLTV.

The guide address can sit in the first line of the playlist, as url-tvg in the #EXTM3U header. Guide files are often packed as .gz or .zip archives, which keeps the download small.

Attribute Where it goes What it does
url-tvg #EXTM3U header line Points the app to the EPG file
tvg-id Each channel line Matches the channel to an XMLTV channel id
tvg-name Each channel line Gives the channel name used in the EPG file
tvg-shift Each channel line Moves that channel’s guide by a set number of hours

Not every app reads every attribute. If your app ignores url-tvg, paste the EPG link into its settings instead, or switch to an Xtream Codes login.

Why is my IPTV EPG empty?

An IPTV EPG is usually empty because the app has not downloaded it yet, the guide link is missing, or a channel’s ID does not match the guide. Work through these checks.

  1. Wait and refresh. After a new login, the guide can take a few minutes to load. Use the app’s refresh or update EPG option.
  2. Check the login type. If you use an M3U playlist, the app may need an EPG link. Ask us for it on WhatsApp.
  3. Try an Xtream Codes login. An Xtream Codes login usually brings the guide in automatically.
  4. Check one channel or all. If only some channels are blank, those channels have no guide match. That is normal for a few channels.
  5. Clear the app cache, then refresh the guide again.

If every channel is blank and channels will not play either, the problem is the login, not the guide. Check your line with our free IPTV checker.

Why does the EPG show the wrong time in the UAE?

The EPG shows the wrong time when your device or app is not set to UAE time, GMT+4. Every programme then shifts by the same number of hours.

The UAE does not use daylight saving, so once it is set correctly, it stays correct all year. A common cause is a device left on UK or US time, for example a box bought abroad. If a guide file gives no time zone at all, XMLTV assumes Universal Time, which also shifts shows by four hours.

Symptom Likely cause Fix
Every show is 4 hours early Device set to GMT Set the time zone to Dubai or GMT+4
Every show is 3 hours early Device set to UK summer time Set the time zone to Dubai or GMT+4
Times shift by 1 hour twice a year App offset set manually around a clock change Set the app’s EPG offset back to 0
Only some channels are wrong Those channels’ guide data uses another zone Use the app’s per-channel offset, or tell us

Many apps also have an “EPG time shift” or “time offset” setting. Leave it at 0 if the device clock is on UAE time.

How do you refresh the EPG in your app?

Most apps refresh the EPG from a settings menu or when you reload the playlist. The option name differs between apps, so look for words such as refresh, reload or update.

Method When to use it
Refresh or update EPG in settings The guide is out of date or runs out after a day or two
Reload the playlist or account New channels are missing from the guide
Close the app fully and reopen it You cannot find a refresh option
Clear the app cache, then reload The guide stays stuck after a refresh

Our best IPTV apps guide covers the layout of IBO Player, HotPlayer, VU Player, CR7 Player and IBO Smart Player.

How does the EPG connect to catch-up?

Catch-up uses the EPG to find old programmes. On channels that support catch-up, you move back along the guide to an earlier show and press play.

If the guide is empty, catch-up has nothing to point to, so fixing the EPG often fixes catch-up too. Channels with catch-up usually show a clock or replay icon. The number of days you can go back varies by channel. It is ideal for UK evening shows and Champions League games that air late in UAE time.

IPTV EPG FAQ

What does EPG stand for?

Electronic programme guide. It is the TV guide inside your IPTV app.

Does an empty EPG mean my IPTV is broken?

No. Channels can play perfectly without a guide. Refresh the EPG first.

Why do some channels have no guide?

Their channel ID has no match in the guide file. This is normal for a small number of channels.

How often does the EPG update?

It depends on the app and the guide provider. You can usually refresh it manually from the settings menu.

What time zone should I use in the UAE?

GMT+4, often listed as Dubai or Gulf Standard Time. It does not change during the year.

What is XMLTV?

An XML format for TV listings. A file holds channels and programmes, and each programme has a channel, a start time and a title.

What is tvg-id in an M3U playlist?

It is the channel’s id in the XMLTV guide. If it does not match, that channel shows no guide.

Do I need a separate EPG link?

Only with some M3U setups. Xtream Codes logins usually include the guide.

Next steps

Guide working? Find tonight’s matches on what’s on tonight, or follow the IPTV setup guide for another device. If channels freeze rather than the guide, check your line with the UAE internet guide. New here? Compare plans or start a free 24-hour trial.

Ready to watch?

Test our service free for 24 hours on e& or du, no VPN and no card. If you like it, plans start at €7.95 a month, or €4.28 a month on the 14-month plan.

About the author: Mohamed

Mohamed runs IPTV UAE and answers customer messages on WhatsApp himself every day. Most of what he writes here comes from those conversations: which player apps work best on Samsung and LG TVs (IBO Player, HotPlayer, VU Player, CR7 Player and IBO Smart Player), how fast a connection needs to be for HD and 4K, and how to stop buffering on match nights. Every guide is checked against our editorial policy before it goes live and updated when something changes.

Questions or a correction? WhatsApp us or read our editorial policy.

author-avatar

About Mohamed

Mohamed runs IPTV UAE and answers customer messages on WhatsApp himself every day. Most of what he writes here comes from those conversations: which player apps work best on Samsung and LG TVs (IBO Player, HotPlayer, VU Player, CR7 Player and IBO Smart Player), how fast a connection needs to be for HD and 4K, and how to stop buffering on match nights. Every guide is checked against our editorial policy before it goes live and updated when something changes.

2 thoughts on “IPTV EPG Explained: How the TV Guide Works”

Comments are closed.