An IPTV EPG, or electronic program guide, is the TV guide inside your IPTV player. The player draws the grid, but the schedule comes from a guide source, normally a file in XMLTV format. With an Xtream Codes login the guide usually loads with the channels. With an M3U playlist you often add the guide URL yourself. The player then matches each channel's ID to the file, so a blank channel usually means an ID mismatch rather than a broken app.
This page explains what the guide is made of, so you can tell which part has failed when it goes wrong. We sell an IPTV subscription, Tivimate IPTV, whose guide is one of those sources, so read our mentions of it with that in mind. We did not build any of the players or tools named here, and none of them pays us.
What Is an IPTV EPG?
It is the listings data behind the grid: channel names, programme titles, start and stop times, and sometimes descriptions and categories. Two separate things have to work for you to see it. Your player, such as TiviMate, Kodi or IPTV Smarters, supplies the screen. A guide source supplies the data. That is why channels can play perfectly beside an empty grid, and why changing the app seldom fixes a guide whose data is missing.
TiviMate shows the split clearly. Its Google Play listing advertises a TV guide grid and also says the app is a media player only and does not provide any content. The guide grid is the app; the listings are not.
Where Does EPG Data Come From?
Nearly always from a file in XMLTV format, a file format for TV listings with its own open-source tools. The file first names its channels, each with an ID, and then lists programmes against those IDs. Its format definition says times can carry a timezone and that UTC is assumed when none is given, which is one reason a guide can appear shifted by a few hours. There are three places you can get such a file:
- Your provider. The usual route, and the one most likely to match your channels.
- A paid guide service. EPG.best, for example, sells an XMLTV source for an existing playlist. We have not used it and do not endorse it.
- A tool you run yourself. iptv-org/epg downloads listings from public sources and writes a guide.xml file on your own machine. The project hosts no finished guide, and its README warns that source sites may refuse heavy traffic.
How Does the Guide Reach Your Screen?
Five things happen between the file and the grid, and a problem at any one of them looks like an empty or wrong guide.
The matching step causes most of the confusion. In an M3U playlist each channel can carry a tvg-id, and the player looks for the same ID in the guide file. The PVR IPTV Simple Client documentation for Kodi describes this directly, including an option to ignore upper and lower case when matching. If your playlist says one thing and the file says another, that channel gets nothing, even though the guide downloaded correctly.
How Do You Add an EPG Source?
Check first whether you need to. With an Xtream Codes login the player normally fetches the guide from the same account, so wait for the first download before changing anything. Our comparison of Xtream Codes and M3U logins sets out the difference. With an M3U link, do this:
- Get the guide URL from your provider. It is a separate address from the playlist.
- Open your player’s guide or EPG settings and add it as a source. Menu names vary by app and version.
- Run a manual update, then leave the app open until it finishes. A large file can take a while.
- Check a channel you know, comparing the listing with what is actually on air.
For the app-specific steps see the TiviMate EPG guide, the Kodi IPTV setup or IPTV Smarters.
Xtream, M3U or a Separate Source?
A separate source is worth trying only when your provider’s guide is missing channels you care about. It helps only if its IDs match your playlist, or if your player lets you assign channels by hand. Keep it to the regions you watch, because a worldwide file is slower to download and takes more space on a small streaming stick.
What Else Depends on the Guide?
Reminders, scheduled recording and catch-up all read the schedule. Catch-up also needs archive streams at the provider; the Simple Client documentation says it supports them only “if supported by the IPTV provider”. So a programme that shows in the guide may still not replay. In TiviMate, catch-up and recording also need the paid upgrade, as our TiviMate Premium guide explains. If you plan to record, a shifted guide means a recording that starts at the wrong time, which is why our IPTV DVR guide puts a correct guide first.
Why Is the Guide Blank or Wrong?
Read the symptom first. A guide that is blank on every channel points at the source or the download. Blank on some channels points at ID matching, or at a source that simply does not list them. Everything off by the same few hours points at the device clock or the time offset. A guide that stops on one date points at a file that has stopped being refreshed, which only whoever publishes it can fix.
Our IPTV EPG not working guide walks through each fix for any player.
Does Your IPTV Service Include a Guide?
Ask before you pay, and test it on the channels you watch. Compare the listings with what is on air during a trial, in your own time zone, as our checklist for buying IPTVsuggests. Tivimate IPTV, which we sell, includes a full 7-day EPG with catch-up on supported channels and offers a free 24-hour trial, so you can run that check on it and judge it as you would anyone else’s. Our plans are on the pricing page.
Frequently Asked Questions
What does EPG mean on IPTV?
EPG stands for Electronic Program Guide. On IPTV it is the grid in your player that shows what is on now and next on each channel. The player draws the grid; the schedule data comes from a guide source, usually your provider.
Is an IPTV EPG free?
A guide source supplied by your provider comes with the subscription. Separately, the open-source iptv-org tool can build a guide file at no charge if you can run it yourself, and paid services such as EPG.best sell one. Your provider's guide is the one to try first, because its channel IDs should already match your playlist.
What is the best EPG for IPTV?
The one whose channel IDs match your playlist and whose listings cover your channels. We have not measured guide sources against each other, so we name no winner. Test a source on the channels you actually watch.
Do I need an EPG to watch IPTV?
No. Channels play without one, because the stream and the guide are separate. You lose the grid, the programme titles and anything built on them, such as catch-up from the guide and scheduled recording.
Does Tivimate IPTV include an EPG?
Yes. The subscription we sell includes a full 7-day EPG with catch-up on supported channels. How it appears depends on the player you use, and that player is separate from the subscription.
Try Tivimate IPTV
55,000+ live channels · 180,000+ movies and series · 4K on selected channels · No contract · From $19.99/month