An IPTV channel guide is the on-screen menu that shows what is on each channel now, what is next and what is coming later in the week. It is usually called an EPG, short for electronic programme guide. It is a separate layer from the channel list itself, which is why a service can have thousands of channels and still show a blank guide. This article explains how the guide is built, how to read it, how to add one to your player and what to do when it stops working.
TL;DR
- The channel list is the lineup you can tune to. The EPG is a separate schedule file that tells you which programme is on and when.
- With an Xtream-style login the guide is usually set up for you. With an M3U playlist you normally add an XMLTV link in the app’s EPG settings.
- Most missing-guide problems come down to five things: a stale cache, a missing XMLTV link, the wrong time zone, mismatched channel IDs, or a guide that has not updated.
- Expect a guide that refreshes every 12 to 24 hours and looks about a week ahead.
- If you are stuck, our 24/7 support and free installation assistance can sort out the setup with you.
Table of Contents
- What an IPTV channel guide actually is
- IPTV channel listings versus the EPG
- How an EPG works behind the scenes
- How to read the guide
- How to get an EPG with your IPTV service
- IPTV EPG not working: five fixes in order
- Why some channels will never look perfect
- A quick checklist before you blame the service
- Our perspective
- Get a service that comes with setup help
- FAQ
- Sources
What an IPTV channel guide actually is
The idea is the same as the guide on your Freeview box or Sky remote. The BBC describes an EPG as an on-screen menu of the TV and radio programmes available, which you normally open with the Guide button on your remote. Its core job is programme discovery. You do not have to flick through hundreds of channels to find what is on. You scroll a menu instead.
IPTV works the same way for the viewer, but the plumbing is different. On a traditional box, schedule data arrives with the broadcast. In IPTV, the video stream and the schedule data travel separately. Your player collects both and puts them side by side on the screen.
A good guide typically shows:
- the channel name and number or logo
- the programme title now airing, with start and end times
- a “next” slot, and often a full grid for later hours and days
- a short description, and sometimes artwork, a genre or an age rating
- actions such as watch now, set a reminder or record, where the app supports them
The exact features depend on the app and the platform, which is the point the BBC page makes about guides generally. A guide on a smart TV app, a Fire TV Stick and a phone can look quite different even when the data behind them is identical.
IPTV channel listings versus the EPG
People often search for “channel listings” and “TV guide” as if they were one thing. They are two different datasets.
| Channel listings | EPG (TV guide) | |
|---|---|---|
| What it is | The lineup of channels you can tune to | The schedule of programmes on those channels |
| Where it comes from | Your M3U playlist or Xtream account | A separate schedule file, commonly XMLTV |
| What it answers | “Is this channel included?” | “What is on, and when?” |
| If it breaks | Channels will not load or are missing | Channels play, but the guide is blank or wrong |
This explains a common frustration. If the guide is empty but the picture plays, nothing is wrong with the stream. As one explanation of IPTV guides puts it, guide quality depends on correct channel matching and feed availability, not on the video pipeline.
If you want to know what a lineup contains before you worry about the guide, our article on what is on an IPTV channel list and how to check one covers that side. You can also browse our channels list.
How an EPG works behind the scenes
Understanding the mechanics makes every fix later in this article obvious.
The XMLTV file
IPTV schedule data is commonly distributed in the XMLTV format. Each file contains channel definitions, each with an ID, and programme entries with start and stop times and titles, sometimes with descriptions and other details, as described in this guide to XMLTV and IPTV guides.
The matching step
Your M3U playlist lists each channel with an identifier, usually the tvg-id attribute. The player looks up that identifier in the XMLTV file and attaches the matching programme entries to the right channel row. If the two IDs are identical, the guide fills in. If one is missing or spelled differently, that channel shows nothing.
Caching and refresh
Players do not download the schedule every time you open the guide. According to one technical explainer on IPTV EPGs, the data is fetched from the provider’s server or XMLTV address, parsed, and stored locally, typically for 12 to 24 hours. When that cache expires, the player fetches fresh data. This is why a guide can look out of date for a day after a source changes.
How far ahead it looks
The same explainer describes XMLTV coverage as commonly running 7 to 14 days ahead per channel. A UK-focused open-source XMLTV project, Permanently’s sky-epg-xmltv, describes generating a rolling 7-day window with daily updates. Guide apps reflect this too: the documentation for IPTV Deck’s guide view describes a grid you can browse across time. In practice, plan on about a week of listings, with the first few hours being the part you use most.
How to read the guide
Most IPTV apps offer two views.
- Now and next. A compact list showing the current programme and the one after it for each channel. It is the quickest way to see what is on this minute.
- Grid view. Channels run down the side and time runs across the top, like the printed listings of old. You scroll sideways for later in the evening and onwards for later days.
Select a programme and you normally get its details and any available actions. Selecting the current programme starts playback. Selecting a future one might offer a reminder.
A few habits make the guide much faster to use:
- Use categories or groups first. Filtering to sport, movies or news before opening the grid cuts thousands of rows to a few dozen.
- Favourite your channels. Most players let you build a short favourites list so the guide opens on what you actually watch.
- Check the clock. If everything appears an hour out, the problem is almost certainly time settings, covered below.
How to get an EPG with your IPTV service
There are two common ways a player receives playlist data, and they handle the guide differently.
Xtream-style login
With a username, password and server address, the EPG is usually integrated. You sign in, and the app pulls channels, on-demand titles and the guide together. If the guide is missing, the first thing to do is refresh the data in the app’s settings.
M3U playlist
With an M3U link, the playlist carries the channels, and the guide is often a separate step. In your player’s EPG or guide settings you add an XMLTV URL, then reload. Our walkthrough on M3U IPTV setup shows how to check a playlist in VLC and where to get guided help. For smart TVs, there is a step-by-step on setting up IPTV Smarters on a smart TV, and our setup page covers other devices.
Choosing a player that handles guides well
Whatever you use, look for these basics:
- a clear place to enter or change the EPG source
- manual refresh and an automatic update option
- a time-offset setting
- a way to match a channel to a guide ID by hand
- a grid view that supports several days
Our service works across devices, and our team can walk you through the app setup if you want it done properly the first time.
IPTV EPG not working: five fixes in order
Work through these from the simplest. Most guides come back by the third step.
1. Refresh or reload the guide
Because players cache the guide for 12 to 24 hours, a stale cache is the most common reason for old or empty listings. Find the update or reload option for EPG in settings and run it. Then close and reopen the app, and give it a few minutes on a large playlist.
2. Check the EPG source
If you use M3U, confirm an XMLTV address is entered at all. Then check that it is the one you were given. Source addresses can change, and channel IDs can drift, which breaks the mapping until the guide is refreshed or reconfigured. If the address was copied with a stray space or a missing character, the guide will load nothing.
3. Correct the time zone and time shift
If programmes show but are one hour early or late, check three things: the time zone on the device, the time zone in the app, and any EPG time shift setting. For UK viewers, the clocks changing in March and October is a classic trigger, so a guide that is suddenly an hour out after a clock change points straight at this step.
4. Fix channel mapping
If only some channels are blank, their tvg-id probably does not match an XMLTV channel ID, or is missing, as the guide to XMLTV matching explains. Many players let you pick the guide entry for a channel by hand. Do it for the handful you watch most. Fixing every channel is rarely worth the time.
5. Use a multi-day source and automatic updates
If the guide empties out by the weekend, your source may only cover a day or two. Choose a source that carries around seven days, and switch on automatic updates so the cache never runs dry. Treat the guide as something that needs the occasional refresh, not a one-off setting.
When to ask for help
If you have done all five and one or two channels remain blank, it is usually a mapping issue that someone with access to your account can see in a minute. That is what support is for. Our team is available 24/7 and installation help is free.
Why some channels will never look perfect
Not every channel has full schedule data. Small regional channels, new additions and pop-up event channels often have thin or no listings, because the guide is built from external schedule sources rather than the stream. A blank row on a minor channel is normal. A blank guide across the board, or on the main channels you use daily, is a setup fault you can fix.
A quick checklist before you blame the service
- Is the picture fine and only the guide wrong? Then it is an EPG problem, not a streaming problem.
- Did it break right after a clock change or an app update? Check time settings, then reload.
- Is it every channel or just a few? Every channel suggests the source address or cache. A few suggests mapping.
- Did you recently change device or app? Re-enter the EPG source in the new app.
- Is your internet fine? A poor connection can stop the guide downloading, even if a cached channel plays.
Our perspective
We think a guide should be the least noticeable part of watching TV. You open it, you see what is on, and you press play. When people write to us about a missing guide, the cause is nearly always a small setup detail, not a failing service, and it is fixable in minutes.
That is why we pair the service with free installation assistance and 24/7 support. Our service offers over 30,000 live channels and more than 140,000 on-demand movies and series in 4K, HD and FHD, and a lineup that large deserves a guide that is set up properly. We would rather walk you through the first setup than leave you to puzzle over IDs and time zones.
Our library is updated regularly and our servers are built to avoid buffering, with antifreezing technology for a steady picture. Pair that with a correctly configured guide and you get what you came for: pick a match, a film or a series, and watch it.
the author
Get a service that comes with setup help
If you are choosing a service as well as sorting out a guide, we offer one IPTV subscription in three lengths: £14 per month, £29 per quarter or £55 per year. Every plan comes with free installation assistance, 24/7 support, compatibility with all devices and our satisfaction guarantee.
You can see the plans on our IPTV subscription page, or look through the shop. If you would like help getting your guide working on your own device, our team will guide you through it.
FAQ
What is EPG in IPTV?
EPG stands for electronic programme guide. It is a schedule file, commonly in XMLTV format, that lists which programmes are on each channel and when. Your player downloads it and matches it to your channel list to build the on-screen guide.
Do I need a separate EPG with IPTV?
It depends on how you log in. With an Xtream-style login the guide is usually included. With an M3U playlist you normally add an XMLTV link in the app’s EPG settings, then reload.
Why is my IPTV TV guide empty or wrong?
The usual causes are an expired cache, a missing or changed XMLTV address, the wrong time zone, or channel IDs that do not match. Refresh the guide first, then check the source, then the time settings. If only some channels are blank, match them by hand.
How often does an IPTV guide update, and how far ahead does it go?
Players typically refresh the guide every 12 to 24 hours, and most XMLTV sources cover about 7 days, sometimes up to 14. Turn on automatic updates so it stays current without you doing anything.
Sources
- What is an EPG? | Help receiving TV and radio (BBC)
- What Is EPG? The IPTV TV Guide Explained
- What Is EPG in IPTV? Complete Guide (2026)
- Permanently/sky-epg-xmltv
- Reading the guide | IPTV Deck