Scrolling through hundreds of live channels with no idea what is on would be exhausting. The electronic program guide — almost always shortened to EPG — solves that by showing the schedule right inside your player app. This guide explains what an EPG is, where the data comes from, how to read it and what to do when it does not match what is playing.
Quick answer: An electronic program guide (EPG) is the on-screen TV schedule in your IPTV app. It lists what is on now and next for each live channel, usually several days ahead, using guide data (often XMLTV) that the app downloads and matches to your channel list.
What is an EPG?
An electronic program guide is an on-screen TV schedule. For each live channel it lists the program on now, what comes next and, in most apps, several days ahead. Many guides add a short description, the start and end times, and sometimes the genre, season and episode number.
Cable and satellite boxes have had built-in guides for decades. In IPTV, the guide is provided as a separate data feed that your player app downloads and lines up with your channel list.
Where IPTV guide data comes from
Most IPTV services publish their schedule in XMLTV, a widely used text format for TV listings. An XMLTV file contains two main parts:
- Channels, each with an ID and a display name.
- Programs, each tied to a channel ID with a start time, stop time, title and optional description.
Your player matches the channel IDs in the guide data with the channels in your playlist. That matching step is why a guide sometimes shows the wrong schedule for a channel: if the IDs do not line up, the app guesses or shows nothing.
How the guide reaches your app depends on the login type:
- With Xtream Codes style logins (server URL, username and password), the app usually fetches the EPG automatically from the same server.
- With an M3U playlist, the playlist may include a guide address in its header, or you may need to paste an EPG URL into the app’s settings. Our guide to M3U playlists explains the format.
How to read an IPTV TV guide
Most apps offer two views:
- Grid view — channels down the left, time across the top, programs as blocks. A vertical line marks the current time. This is the classic cable-style layout.
- Channel view — pick one channel and see its upcoming programs as a list.
Useful things to look for:
- Now and next labels, often shown in the channel list without opening the full grid.
- Program details — press OK or select a program to read its description.
- Catch-up markers — on channels with archive support, past programs may show an icon you can select to watch them. See our explainer on catch-up TV.
- Reminders — some apps let you set a reminder that switches to the channel when a program starts.
EPG settings worth knowing
Player apps tend to bury guide options in their settings. These are the ones that matter most:
| Setting | What it does |
|---|---|
| EPG source or URL | Where the app downloads guide data from |
| Update interval | How often the guide refreshes (daily is common) |
| Time offset / time shift | Moves the whole guide forward or back by whole hours |
| Days to keep | How much past and future data the app stores |
| Auto-update on start | Refreshes the guide whenever you open the app |
The time offset setting is the one people need most often. If every program appears exactly one or several hours early or late, the guide and your device disagree about the time zone. Check that your device’s time zone is correct first, then adjust the offset only if needed. We cover the full list of player settings in a separate guide.
Why an EPG can look wrong
Even good guide data occasionally misbehaves. The common causes are:
- The guide has not finished downloading. Large XMLTV files can take a minute or two on slower devices, especially the first time.
- Wrong time zone or clock. A device with the wrong date, time or time zone will show the wrong “now” line.
- Channel ID mismatch. A channel was renamed or added and its ID does not match the guide data yet.
- No data for that channel. Some channels simply do not have listings available.
- Cache problems. An old copy of the guide is stuck in the app’s storage.
For a step-by-step fix, follow our troubleshooting guide for when the IPTV EPG is not showing.
Does the EPG use a lot of data or storage?
Guide files are text, so they are small compared with video — usually measured in megabytes rather than gigabytes. On low-storage devices such as older streaming sticks, though, keeping many days of guide data for thousands of channels can slow an app down. If your device feels sluggish, reduce the number of days stored or hide channel groups you never watch.
Making the guide work for you
A few habits make the EPG far more useful:
- Build a favorites list so the grid only shows the channels you actually watch.
- Hide unused categories to speed up loading and scrolling.
- Refresh the guide manually after your service tells you about channel changes.
- Use the search feature in apps that offer it to find a program by name across all channels.
With StreamIPTV, a program guide is included for live channels on every plan, and the setup instructions we send explain where to find it in your app. If something looks off, message us with your device and app name, or check the IPTV FAQ for quick answers.
