What Is an EPG? A Guide to IPTV Program Listings

An EPG, short for electronic program guide, is the on-screen grid that shows what is playing on each channel now and what is coming up later. On cable or satellite it arrives with the broadcast. With IPTV (television delivered over your internet connection) it works differently: an IPTV EPG is a separate data feed that your app downloads, matches to your channels and lays out as a guide. Understanding that separation explains almost every guide problem people run into, from empty listings to programs that appear a few hours off.

This guide covers what an IPTV EPG contains, the XMLTV format most feeds use, how channels are matched to their listings, why time zones cause confusion, and what to check when the guide does not look right.

What an IPTV EPG actually is

Think of the guide as a schedule sheet laid over your channel list. For every channel it holds a sequence of programs, each with a title, a start time, an end time and usually a short description and category. Your app draws that information as a grid, with channels down the side and time across the top, and highlights whatever is on right now.

The guide and the video are two different things from two different places. The video for a channel comes from a stream address in your playlist or from the server behind your Xtream Codes login (server URL, username and password). The listings come from an EPG feed, which is a file the app downloads on a schedule. The video can work perfectly while the guide is empty, and the guide can be full while a channel refuses to play. The general concept is described on Wikipedia’s electronic program guide page.

XMLTV: the format behind most IPTV EPG feeds

Nearly all IPTV guide feeds use a format called XMLTV. It is a plain-text file written in XML, a structured format that both people and software can read. The file has two main parts. The first is a list of channels, each with an identifier and a display name. The second is a long list of programs, and each program record says which channel it belongs to, when it starts, when it ends, and what it is called.

Because the file covers every channel for several days ahead, it can be large, often tens of megabytes for thousands of channels. That is why apps download it once or twice a day rather than every time you open the guide, and why the first load after setup can take a few minutes. Most apps let you choose how often to refresh and how many days of listings to keep.

Some feeds are provided compressed, and you may see a file name ending in .gz. Apps handle this automatically; you do not need to unzip anything.

How channels are matched to listings: tvg-id

This is the part that causes the most confusion, so it is worth slowing down. The playlist and the IPTV EPG are separate files, so the app needs a way to know that the channel called “News One HD” in your playlist corresponds to the schedule labeled “news1.us” in the guide. That link is the tvg-id attribute.

In the playlist, each channel entry carries a tvg-id value. In the XMLTV file, each channel has an id. When the two match exactly, the app attaches the schedule to the channel. When they do not match, that channel shows “No information” or an empty row. Our guide to M3U playlists and the tags inside them explains where this attribute sits.

Why some channels have no guide data

• The channel has no tvg-id in the playlist, so there is nothing to match.
• The ID in the playlist does not match the ID in the guide, often because of a small difference such as capitalization or a country suffix.
• The guide source has no schedule for that channel at all. This is common for smaller regional channels, 24/7 themed channels and event feeds.
• The guide simply has not finished downloading yet.

Some apps let you fix a mismatch by hand: open the channel’s settings, look for an option such as EPG source or Change EPG, and pick the correct listing from the guide. This is a per-channel fix on that device and does not change the provider’s data.

Xtream login vs M3U: where the guide comes from

How you signed in affects how the guide arrives. With an Xtream Codes login, the app usually fetches guide data from the same server through its API (a structured interface the app can query), with no extra setup. The IPTV EPG arrives already matched to the channels because the provider maintains both.

With an M3U playlist link, the guide is a second address. Your provider may supply a separate EPG URL, and you paste it into the app’s EPG or XMLTV field. IPTVOID includes a TV guide with its service, and a separate EPG URL may be supplied where an app needs one; if your activation email does not show it, support can send it. The setup guide for 15 devices shows where the EPG field lives in each app.

Time zones and the IPTV EPG offset

If every program in your guide appears a few hours early or late, nothing is broken in the feed. It is a time zone question. Each program in an XMLTV file carries its start time with a time zone offset, for example a schedule published in UTC (Coordinated Universal Time). Your app converts those times to the time zone your device is set to. If the device clock or time zone is wrong, the whole guide shifts.

Two settings matter here. The first is your device’s own date, time and time zone, which should be set to automatic. The second is an app setting usually called EPG time shift or EPG offset, which lets you nudge listings forward or back by whole hours. Use it only if the device time zone is correct and the guide is still consistently off, which can happen when a feed was published without an offset. Change it one hour at a time and check a channel whose schedule you know.

Daylight saving changes are the other classic cause. If your guide was fine last week and is an hour off this week, a clock change on either side is the first thing to suspect.

What a good IPTV EPG gives you beyond the schedule

Once the guide is populated, a lot of app features depend on it.

• Browsing by time: scroll ahead to see what is on tonight without flipping channels.
• Reminders and scheduled recording: apps that support these use the guide’s start and end times.
• Catch-up: where a provider offers catch-up TV, the app uses guide data to show which past programs are available. Our overview of live TV, VOD and catch-up explains how these differ.
• Search: finding a show by name across every channel only works when listings are loaded.

Guide quality varies by provider and by channel: a service can have an excellent lineup and patchy listings for some channels, or the reverse. This is one more reason to test on your own device. A long channel list alone does not tell you how a service will work for you, and the guide is part of the daily experience.

Quick checks when the guide looks wrong

1. Wait. After setup, give the app several minutes to download the full feed.
2. Look for a refresh or update EPG option and run it manually.
3. If you use an M3U link, confirm the EPG URL is entered and matches the latest one from your provider.
4. Check the device date, time and time zone.
5. If only certain channels are blank, check whether the app lets you reassign the EPG source for that channel.
6. If the guide is still empty on every channel, contact your provider’s support and say which app you use and how you logged in.

For a longer walkthrough, see IPTV guide not updating? How to troubleshoot EPG issues.

Frequently asked questions

Does the IPTV EPG use a lot of data?

Very little compared to video. A full guide file may be a few megabytes to a few tens of megabytes, downloaded once or twice a day. An hour of HD video uses far more.

Why does the guide work on my phone but not my TV?

Usually because the two apps were set up differently. One may use an Xtream login that fetches guide data automatically, while the other uses an M3U link without the EPG URL filled in. Compare the settings on both devices and copy the missing EPG address across.

Can I use my own EPG source?

Many apps allow a custom XMLTV URL. Listings only appear if the channel IDs in that feed match the tvg-id values in your playlist, which is not guaranteed with a feed from elsewhere. The provider’s own feed is almost always the better match.

Is the EPG the same as catch-up?

No. The guide is the schedule. Catch-up is the ability to play a program that already aired, which only some providers offer and only on some channels. The app uses the guide to show what is available, but the video itself still comes from the provider’s server.

The bottom line on the IPTV EPG

An IPTV EPG is a separate schedule feed, usually in XMLTV format, that your app matches to channels through the tvg-id attribute and converts to your local time. Once you see it that way, empty rows, wrong listings and shifted times stop being mysteries and become three specific things to check.

The best way to judge a guide is to use it for an evening on your own device. IPTVOID includes a TV guide with every plan, and viewers in the USA, Canada, the UK and Norway can request a 24-hour free trial with no credit card to see how the listings look in the app they already use.