Skip to content
IPTV Smarters Pro
Setup

How to add an EPG programme guide to your player app

Published 3 min read

Person on a sofa holding a TV remote next to a bowl of popcorn

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:

  1. Open the app's settings and look for a section named EPG, TV Guide or Sources.
  2. Choose to add a source and enter the XMLTV address exactly as supplied.
  3. Link the source to your playlist if the app asks.
  4. Start an update and wait. A large guide file can take several minutes on a streaming stick.
  5. 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.

Keep reading