Blog
IPTV EPG Explained: How the TV Guide Works
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.

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?
- How does the IPTV EPG work?
- What does an XMLTV guide file look like?
- How does an M3U playlist link to the EPG?
- Why is my IPTV EPG empty?
- Why does the EPG show the wrong time in the UAE?
- How do you refresh the EPG in your app?
- How does the EPG connect to catch-up?
- IPTV EPG FAQ
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.
- 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.
- Check the login type. If you use an M3U playlist, the app may need an EPG link. Ask us for it on WhatsApp.
- Try an Xtream Codes login. An Xtream Codes login usually brings the guide in automatically.
- Check one channel or all. If only some channels are blank, those channels have no guide match. That is normal for a few channels.
- 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.
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.
2 thoughts on “IPTV EPG Explained: How the TV Guide Works”
Comments are closed.