Skip to content
pitchside TV home
Streaming Technology

What is EPG on IPTV, and why is my guide empty?

The TV guide in your IPTV app is a separate data feed from the channels themselves. Here is how it works and how to fix the most common guide problems.

By Pitchside TV Editorial TeamPublished 3 min read

Viewer relaxing in front of a TV showing a film library in a room lit with purple light

EPG stands for electronic programme guide: the grid of listings that tells you what is on now and next. In an IPTV app, the EPG is delivered separately from the video. That is why a channel can play perfectly while its guide shows "No information".

Where guide data comes from

Programme listings are published as a data feed, most commonly in a format called XMLTV. An XMLTV file lists channels, each with an ID, and programmes, each with a start time, end time, title, description and the ID of the channel it belongs to.

Your player app downloads this file and matches it to your channel list. How it gets the file depends on your login:

  • Xtream Codes logins usually provide the guide automatically. The app requests it from the same server as your channels. See Xtream Codes login.
  • M3U playlists often need a separate EPG link added in the app settings. See M3U playlist.

How matching works

Each channel in an M3U playlist can carry a tvg-id value. The app looks for programmes in the XMLTV file with the same channel ID. If the IDs match, listings appear. If a channel has no ID, or the ID does not exist in the guide file, that channel's guide is empty.

This explains most guide oddities:

SymptomLikely cause
Whole guide emptyThe guide has not been downloaded, or no EPG source is set
One channel emptyThat channel's ID is missing from the guide data
Listings on the wrong channelTwo channels share an ID, or an ID is mismatched
Everything an hour outTime zone or daylight saving offset is wrong
Guide runs out after a day or twoThe feed only covers a short period; it needs refreshing

Fixing common guide problems

  1. Refresh the guide

    Find Update EPG, Refresh EPG or Install EPG in your app. Guide files can be large, so give it a few minutes, and keep the app open while it downloads.

  2. Check the source

    In the app's EPG settings, confirm a guide source is listed. For M3U playlists, add the guide link you were given.

  3. Check the time zone

    If every programme is shifted by the same amount, check the device's time zone and the app's EPG time offset setting. Around the clock changes in March and October, this is the usual culprit.

  4. Set a refresh interval

    Apps such as TiviMate can update the guide automatically every day. Make sure it is turned on.

Why the guide matters for catch-up

Where a service offers catch-up, the guide is how you find past programmes: you scroll back in the grid and select the programme to play it. If the guide is wrong, catch-up will start at the wrong place. Getting the EPG right first makes catch-up work properly.

Making the guide easier to use

  • Favourites: build a favourites group so the guide shows only the channels you watch.
  • Hide categories: remove groups you never use to make the guide faster.
  • Guide layout: TV-focused players let you change how many rows and hours are visible. Fewer rows are easier to read from the sofa.

If the guide is still wrong for a particular channel after a refresh, let your provider know which one. It is usually a data fix on their side, not something wrong with your setup.

Try a month for £10

Test it on your own TV and broadband, then pick the plan that fits.