IPTV EPG: What It Is and How to Add a TV Guide to Your Player

A channel list on its own is just names. The EPG — electronic programme guide — is what turns it into a real TV guide, showing what’s on now, what’s next and what’s coming later in the week. This guide explains how IPTV EPG data works, how to add it to your player, and how channels are matched to the right programmes.

How IPTV guide data works

Most IPTV guides use a format called XMLTV. It’s a structured text file (often compressed as .xml.gz) with two parts:

1. Channels — each with an ID, such as news1.example, and a display name.
2. Programmes — each with a start time, end time, the channel ID it belongs to, a title and often a description.

Your player downloads this file and matches its channel IDs to the channels in your playlist. When the IDs match, programme information appears in the guide.

Where the guide comes from

Login type	Where the EPG usually comes from
Xtream Codes	Loads automatically through the login
M3U playlist	A separate XMLTV link from your provider, or a link inside the playlist header
Smart TV apps	Entered on the app developer’s website along with the playlist

If you’re not sure which login you have, our guide to M3U playlists explains the difference.

How to add an EPG link

The steps are similar in every player:

1. Find the guide settings — usually Settings → EPG, TV guide or EPG sources.
2. Choose Add EPG or Add source.
3. Paste the XMLTV link from your provider.
4. Choose Update and wait. The first download can take several minutes for large guides.

Player-specific notes:

• TiviMate: add the source under the EPG settings and assign it to your playlist if you have more than one.
• IPTV Smarters: use Install EPG from the home screen.
• Kodi: add the XMLTV URL on the EPG tab of PVR IPTV Simple Client — see our Kodi IPTV setup guide.
• Samsung and LG apps: add the EPG link on the developer’s website, next to your playlist.

How channels are matched

Matching is where most guide problems start. Players use, in order of reliability:

1. tvg-id in the playlist matching the channel ID in the guide — the most reliable.
2. Channel name matching — works when names are identical, fails when they differ slightly (“News One HD” vs “News One”).
3. Manual matching — some players let you choose the guide entry for a channel yourself.

If most channels have guide data but a few don’t, manual matching usually fixes them. If none do, the EPG link itself is the problem.

Guide settings worth knowing

• Update frequency: daily is usually enough; set it to update at start-up if your provider’s guide changes often.
• Days to keep: fewer days means faster loading and less memory use.
• Time shift / offset: corrects programmes shown an hour or more early or late.
• Hide channels without guide data: cleans up the grid if you only want channels with programme information.

For the wider set of player options, see IPTV player settings explained.

Compressed guide files

Guide files are often large, so providers frequently compress them. A link ending in .xml.gz points to a compressed file; most players unpack it automatically. If your player doesn’t accept a compressed link, ask your provider whether an uncompressed .xml version is available. Compressed guides download faster, which helps on slower connections and small devices.

Using more than one guide source

Some players let you add several EPG sources — for example, your provider’s guide plus a second source for a handful of channels it doesn’t cover. When you do:

• Set a priority so the player knows which source to trust first.
• Watch for duplicates, where two sources describe the same channel differently.
• Keep it minimal — every extra source adds download time and memory use.

For most people, the provider’s own guide is enough.

Using the guide day to day

• Browse ahead to see what’s on later and plan your evening.
• Set reminders where your player supports them.
• Use catch-up from past programmes in the guide if your provider offers it.
• Search the guide for a programme title across all channels.

When the guide doesn’t work

An empty guide, the wrong programmes on a channel, or times an hour out are common, and almost always fixable. Our guide to EPG not working goes through each problem step by step.

A practical example

Suppose your provider sends an M3U link and a separate guide link ending in .xml.gz:

1. You add the M3U link to your player; 400 channels load, but the guide shows “No information”.
2. In the EPG settings you add the .xml.gz link and choose Update.
3. After a few minutes, most channels show programmes. Three channels named slightly differently stay empty.
4. You use manual matching to link those three to the right guide entries.
5. Programmes show an hour early, so you set a one-hour time shift.

Ten minutes of setup gives you a guide that behaves like a traditional TV.

The bottom line

An IPTV EPG is an XMLTV file that your player matches to your channels. Add your provider’s guide link if it doesn’t load automatically, give the first update time, fix stray channels with manual matching, and set the time shift if programmes are out by an hour.