What is an IPTV EPG, and how does XMLTV work?

By Pedro Rodrigas · Last updated November 18, 2026 · 5 min read

A subscription normally comes with two links, and people load the first and ignore the second. The first is the playlist, with the channels. The second is the EPG, the schedule that turns a list of names into something that looks like TV. They are separate because they come from separate places, which explains most guide problems.

Illustration of a TV showing a programme guide grid, for IPTV EPG and XMLTV

An EPG is the TV schedule, and IPTV carries it in a separate XMLTV file with its own URL. The playlist tells your player which channels exist, and the EPG tells it what is on them and when. A player with a playlist and no EPG shows channel names and nothing else.

What you need to know

  • EPG stands for Electronic Programme Guide: the IPTV guide of what is on and when.
  • IPTV delivers it as an XMLTV file at its own URL, separate from the playlist.
  • An Xtream Codes login loads the guide automatically.
  • Channels are matched to the guide by the tvg-id in the playlist.
  • A guide shifted by whole hours is a timezone setting in the player.
  • Seven days of listings ahead is normal.

What is EPG on TV and in IPTV?

On TV, the EPG is the on-screen schedule. On cable it travels with the signal, but in IPTV it comes as a separate file, because the playlist and the schedule are made by different systems. The playlist is a list of addresses, and the schedule is a database of what is showing on thousands of channels over the next week.

Playlist (M3U)Guide (XMLTV)
ContainsChannel names and addressesProgramme titles, times and descriptions
SizeA few hundred KBOften tens of MB
RefreshedWhen you reload itEvery few hours, by the player
Without itNothing playsChannels play, with no schedule

The size is why the guide is separate, and why it is slow. A week of listings for several thousand channels is a large file, and your player downloads and reads all of it.

How do you add an EPG to your player?

Paste the EPG URL into the player's EPG or guide settings, which are never next to the playlist box. That is why people skip it.

PlayerWhere the EPG URL goes
IPTV SmartersUsually automatic with an Xtream Codes login. Otherwise, in the EPG settings
TiviMateIn the EPG settings, as an EPG source
KodiPVR IPTV Simple Client → Configure → EPG Settings
Plex, Emby, JellyfinLive TV, as an XMLTV guide source
Smart IPTV and SET IPTVOn the app's website, next to the playlist field
VLCNot supported, because VLC has no guide
If you log in with Xtream Codes

You may not need the EPG URL at all. An Xtream Codes login carries the playlist and the guide together, which is the main practical reason to prefer it over a plain M3U link.

Where do you get an IPTV EPG source?

From your provider: the EPG source for IPTV that matches your playlist is the one your provider gives you. Free EPG sources exist, but they rarely match a paid line-up.

The best-known free source is the iptv-org EPG project on GitHub, which builds XMLTV guides from public listings. A free EPG XML URL like that matches the channels in public playlists, so its channel IDs seldom line up with the tvg-id values in a paid playlist.

Why is the IPTV guide wrong?

Four different faults look the same from the sofa: shifted times, some channels without a guide, an empty guide, and a guide a day behind. Each has its own fix.

  1. All the times are shifted by a whole number of hours. That is a timezone setting in the player, not the file. Usually the player is on automatic and has guessed wrong.
  2. Some channels have a guide and others do not. That is channel matching: the guide finds channels by an ID that must match the tvg-id in your playlist, and when they differ the channel gets no data. The provider has to correct it.
  3. The whole guide is empty. The EPG URL was never added, or it went into the playlist field, so check which box it is in.
  4. The guide is right but a day behind. The player cached it and has not refreshed, so force a refresh in the EPG settings.

Working through guide problems by symptom.

What does tvg-id do?

It is the key a player uses to find each channel in the XMLTV file, so when it does not match, that channel's guide stays empty. It explains the case where half the channels have a guide and half do not.

Each line in your playlist can carry attributes, and tvg-id is one of them. If the playlist says tvg-id="BBCOne.uk" and the guide file calls the channel bbc1.uk, there is no match, and the channel shows an empty schedule even though both files are valid.

This is a provider-side problem and a fair thing to raise with support. You can also repair it yourself for a few channels by editing the playlist so the IDs match.

How good should an IPTV guide be?

The channels you watch should all have data, seven days ahead, with correct times once the timezone is set. No provider covers every channel perfectly.

  • The channels you watch should all have data. Not every channel in a line-up of thousands, but the ones you use.
  • Seven days ahead is normal, and fourteen is generous.
  • Times should be right once the timezone is set. If they are still wrong after that, the data is the problem.
  • Not every channel will have a guide. Small international channels often have none anywhere, from any provider.
  • Descriptions will be thin on smaller channels. Titles and times are the part that matters.

Test this during the 24-hour trial: open the guide on the ten channels you actually watch. An empty guide on a trial stays empty after you pay.

Frequently asked questions

What is EPG in IPTV?

The electronic programme guide: the schedule of what is on each channel and when. IPTV carries it in a separate XMLTV file with its own URL, because it is made separately from the playlist and is much larger.

What is an EPG URL?

The second link your provider gives you, next to the playlist. It points to an XMLTV file with the schedule, and it goes in a different field from the playlist URL in every player.

Why is my EPG empty?

Usually the EPG URL was never added, or it was pasted into the playlist field. If some channels have a guide and others do not, the channel IDs in the playlist do not match those in the guide file, which the provider has to fix.

Why is my TV guide showing the wrong times?

A timezone setting in the player, not a fault in the data. If everything is shifted by a whole number of hours, set the timezone in the player yourself instead of leaving it on automatic.

Do I need an EPG URL if I use Xtream Codes?

No, usually not. An Xtream Codes login delivers the playlist and the guide together from the same server.

Is there a free EPG XML URL for IPTV?

Yes, projects such as the iptv-org EPG publish free XMLTV guides, but they match public playlists, not paid line-ups. For a subscription, use the EPG URL your provider gives you.

Ready to start watching?

A 24-hour trial, set up in a few minutes on the device you already own.