Quick answer: EPG stands for Electronic Programme Guide. In IPTV it is the TV guide that shows what is on now and next for each channel. Your player gets it either from your provider (with an Xtream Codes login) or from a separate XMLTV link that you add next to an M3U playlist. If the guide is empty or shows the wrong times, the cause is almost always a channel ID mismatch or a time zone setting.
What is an EPG?
An EPG is a schedule of programmes: titles, start and end times and short descriptions. On a normal TV it is the guide you open with the remote. In an IPTV player it works the same way, but the data is downloaded from the internet.
The EPG is separate from the streams. A channel can play perfectly with no guide data at all. New to IPTV? Read what is IPTV first.
What is XMLTV?
XMLTV is the most common file format for EPG data. It is a text file, usually a large XML file, that lists every channel with its programmes. You give your player the address of that file (an XMLTV URL) and the app downloads it and matches it to your channels.
How the guide gets matched to channels
Each channel in your playlist has an ID (in M3U files it is the tvg-id value). The XMLTV file uses the same IDs. When they match, the app shows the right programmes. When they do not, the channel shows no guide. Read what is an M3U playlist to see where the ID sits in the file.
Where does the EPG come from?
| Login type | Where the guide comes from |
|---|---|
| Xtream Codes | Usually delivered by your provider with the account. See Xtream Codes explained |
| M3U playlist | A separate XMLTV link from your provider, or the one inside the playlist if it has one |
If your provider does not supply a guide, ask support. Some do not include one.
How to add an EPG
In TiviMate
- Add your playlist
- When the app asks for an EPG source, choose the playlist’s guide or add the XMLTV link
- Wait for the guide to download. The first download can take a few minutes
More steps in our TiviMate setup guide.
In IPTV Smarters Pro
- Add your user using Xtream Codes or M3U
- If you use M3U and there is an EPG field, paste the XMLTV link
- Open the guide from the Live TV section
See also the IPTV Smarters Pro guide.
In Kodi
- Install the PVR IPTV Simple Client add-on
- Set the M3U playlist location
- Set the XMLTV location to your guide link
- Restart Kodi and open the TV section
Common EPG problems and fixes
- No guide on any channel: check that the XMLTV link is correct and has finished downloading. Check your internet connection
- Guide missing on some channels: the channel IDs do not match. Ask your provider for the correct guide, or use the app’s channel-mapping option if it has one
- Wrong times: check the time zone and the time offset setting in your app and your device
- Guide is out of date: refresh the guide manually or set the app to update it more often
- App slows or freezes while loading the guide: a very large XMLTV file can overload a weak device. Free storage and restart
If streams also stutter, see our IPTV buffering guide.
Tips for a better TV guide
- Use the guide link supplied by your provider first, because it matches their channel IDs
- Keep the app updated, because guide handling improves over time
- Set the guide to refresh daily if the app allows it
- Hide channels you never watch to speed up the guide
Frequently asked questions
What does EPG stand for?
Electronic Programme Guide, the on-screen schedule of programmes for each channel.
Is EPG the same as XMLTV?
Not exactly. EPG is the idea of a TV guide. XMLTV is a common file format used to deliver EPG data.
Why is my IPTV guide empty?
The usual causes are a missing or wrong XMLTV link, channel IDs that do not match, or a guide that has not finished downloading.
Does the EPG affect streaming quality?
No. The guide only shows programme information. Picture quality depends on the stream and your connection.
Do I need an EPG?
No. You can watch without one, but a guide makes it easier to see what is on and to set reminders in apps that support them.
Next steps
Check which guide link your provider supplies, add it to your player and let it download. If you still need a provider, compare the available subscription plans and ask support whether a TV guide is included.