How to Set Up EPG for IPTV in 2026: TiviMate & More

Last updated: · By WatchlyGuide Team

To set up an EPG, get the XMLTV guide URL from your IPTV provider, add it as an EPG source in your player’s settings, and let it match programmes to your channels by their IDs. The guide data comes from your provider — the player just displays it. This guide covers adding an EPG in TiviMate, IPTV Smarters and OTT Navigator, fixing channel-ID mismatches, and a troubleshooting table. It pairs with our how to add an M3U playlist guide.

An IPTV player showing a full EPG programme guide grid
Setting up an EPG — add the XMLTV source and the guide fills your channel list.

Before You Start

You need an XMLTV EPG source from your provider and a player that supports it:

You need Detail
EPG source An XMLTV URL/file from your provider
Matching playlist Your M3U or Xtream already loaded
Player TiviMate, IPTV Smarters, OTT Navigator (not VLC)
Correct time zone Set on the device, so the guide aligns

Step-by-Step (by Player)

TiviMate

  1. Open Settings → EPG → Add EPG source.
  2. Paste the XMLTV URL and download it.
  3. Let TiviMate auto-match by channel ID; assign sources manually for any blank channels.

IPTV Smarters

  1. If using Xtream Codes, the EPG usually loads automatically.
  2. For M3U, add the XMLTV URL under EPG settings and refresh.

OTT Navigator

  1. Open playlist settings → EPG, add the XMLTV URL.
  2. Enable auto-matching, then check the guide populates.
Diagram showing a playlist tvg-id matching an XMLTV channel ID, and a second pair that fails because the playlist holds the display name instead
The EPG matches by channel ID (tvg-id) — mismatches are the usual cause of a blank guide.

How Matching Works

An EPG attaches programmes to channels using channel IDs — the tvg-id in your playlist must match the id in the XMLTV data, character for character:

tvg-id="bbcone.uk"    =  <channel id="bbcone.uk">   ✓
tvg-id="BBC One HD"   ≠  <channel id="bbcone.uk">   ✗

When they line up, the guide fills automatically. The second line is the usual failure: the playlist carries the channel’s display name instead of its ID, so the player has nothing to attach the schedule to and the channel shows no programmes. The fix is to use the EPG your provider recommends for that playlist, enable auto-matching, or map channels to EPG sources manually in the player.

Troubleshooting

Problem Likely cause Fix
No guide at all EPG source not added Add the XMLTV URL in EPG settings
Some channels blank Channel-ID mismatch Auto-match or map channels manually
Wrong programmes shown Mismatched IDs Use the provider’s recommended EPG
Times are off Wrong device time zone Set the correct time zone on the device
Guide slow to load Very large XMLTV file Limit to fewer days if the player allows

The Bottom Line

Setting up an EPG is quick: take the XMLTV URL from your provider, add it as an EPG source in a proper IPTV player, and let it match programmes to channels by their IDs. Mismatched IDs are the usual culprit behind a blank guide — use the provider’s recommended EPG and auto-matching. Learn the background in what an EPG is, add your playlist with our M3U playlist guide, organise your channels in our TiviMate channels guide, see the TiviMate review, and look up any term in the streaming glossary.

Frequently Asked Questions

What is an EPG and where do I get one?

An EPG (Electronic Programme Guide) is the on-screen TV schedule showing what's on now and next. For IPTV, it comes as an XMLTV file or URL, usually supplied by your provider alongside your playlist. Some players also pull EPG data automatically from the playlist. You add the XMLTV URL in your player's settings to populate the guide.

Why is my EPG not showing correctly?

The most common cause is a channel-ID mismatch: the EPG's tvg-id values don't match your playlist's channels, so programmes attach to the wrong channel or none. Fix it by using the EPG your provider recommends, enabling auto-matching, or manually mapping channels to EPG sources in the player. A wrong time zone can also shift the guide.

How do I add an EPG in TiviMate?

In TiviMate, open Settings, then EPG, add an EPG source, and paste the XMLTV URL from your provider. Let it download and process, then TiviMate matches programmes to channels by their IDs. If some channels stay blank, use the channel's settings to assign the correct EPG source manually.

Does the EPG use extra data or slow things down?

An EPG download is a small XML file refreshed periodically, so it uses little data. Very large guides with many days of data can take a moment to process on low-powered devices, briefly slowing the channel list. Limiting the guide to a few days, if your player allows, keeps it fast on a cheap streaming stick.

Can I use an EPG with VLC?

Not really. VLC plays IPTV streams but has no proper EPG or channel-guide interface, so programme data won't display usefully. For a working EPG you need a dedicated IPTV player like TiviMate, IPTV Smarters or OTT Navigator, which are built to download XMLTV data and map it to your channels.