How to add an EPG programme guide to your player app
Published 3 min read

An electronic programme guide, or EPG, turns a plain list of channels into something you can browse like a TV schedule. It shows what is on now, what comes next and often a short description. Getting it right takes a little patience, because guide data normally travels separately from the video.
How guide data works
Most player apps read EPG information in a format called XMLTV. An XMLTV source is a file, frequently compressed with gzip, that lists channels and programmes with start and end times. The app downloads it periodically and stores the schedule locally.
The crucial detail is the link between the two lists. Each channel in your playlist can carry an identifier, usually in a field called tvg-id. The guide uses identifiers too. When they match, listings appear beside the right channel. When they do not, the channel stays blank, even though the guide itself loaded correctly.
What you need first
- A channel list that already loads and plays. See the setup guide for your device if not.
- A guide source. Your service may provide an XMLTV address, or supply guide data automatically through a server login.
- The correct date, time and time zone on your device.
Adding a guide source step by step
Menus differ, but the sequence is nearly always the same:
- Open the app's settings and look for a section named EPG, TV Guide or Sources.
- Choose to add a source and enter the XMLTV address exactly as supplied.
- Link the source to your playlist if the app asks.
- Start an update and wait. A large guide file can take several minutes on a streaming stick.
- Open the guide view and check a handful of well-known channels.
If you log in with a server address, username and password, try the guide view before adding anything. Many apps fetch listings automatically with this kind of login.
When the guide is blank or wrong
Listings are missing on some channels
This is typically an ID mismatch. Some apps let you assign a guide channel by hand, which is worthwhile for your favourites. A playlist can be excellent and a guide can be excellent, and they may still use different naming.
Everything is shifted by an hour or two
Start by checking the time zone on the device. Across Europe, a guide published in UTC needs correct local offset handling, and daylight saving changes in spring and autumn can reveal a wrong setting. Many apps also include a guide time offset for manual correction.
The guide stopped updating
Sources change or expire. Open the guide settings, look at the time of the last update and start one manually. If it fails, confirm the address still works and ask whoever supplied it.
The app slows down after loading the guide
Very large guide files are demanding on low-powered devices. If possible, use a source covering only the countries you watch, and reduce the number of days the app stores.
Keep it low maintenance
Set the app to update the guide once a day rather than each time it starts, which makes launch faster. If your playlist changes, recheck the channel mapping, since new entries may have new IDs.
Guide trouble is seldom the only annoyance on a new setup. If channels also stutter, read why streams buffer, and browse our troubleshooting page for other symptoms.
Sources
The official pages behind the facts in this article. Stores and websites change, so each source shows the date we checked it.
- Kodi – PVR IPTV Simple Client add-on (GitHub) · checked on 17 November 2026
Keep reading

Basics
M3U playlist or Xtream login: which one should you use?
M3U links and Xtream-style logins both load channels into a player app, but they behave differently. Learn how each works and when to use it.
4 min read

Setup
Kodi with PVR IPTV Simple Client: add an M3U playlist and an XMLTV guide
Set up PVR IPTV Simple Client in Kodi: where to enter your M3U playlist and XMLTV guide, the settings that matter, logos, time shift and common questions.
3 min read

Setup
IPTV players for Android: which app to choose on phone and tablet?
Which IPTV player for Android should you choose? What official sources confirm about VLC, Kodi, TiviMate and IPTV Smarters, plus the criteria that matter.
3 min read
