What is an EPG? The IPTV TV guide explained

Updated November 20, 2026 · 4 min read

EPG stands for Electronic Program Guide – the TV guide that tells you what's on now, what's next, and what's coming later tonight. In IPTV, the guide isn't part of the video stream. It comes as separate data that the app downloads and matches to your channels. Here's how that works, and how to use the guide in VyraTV.

How an IPTV TV guide works

A playlist only contains channel names and stream addresses. The program information – titles, start and end times, descriptions – lives elsewhere. There are two common ways to get it:

1. XMLTV guide files (for M3U playlists)

XMLTV is the standard format for TV guide data. It's an XML file with a list of channels and their programs. Providers usually point to it from the first line of the M3U playlist using an attribute called url-tvg:

#EXTM3U url-tvg="https://example.com/guide.xml"
#EXTINF:-1 tvg-id="example.channel" group-title="General",Example Channel
https://example.com/stream/1.m3u8

Each channel line has a tvg-id. The app uses it to find the matching channel in the XMLTV file. That's why the guide sometimes shows nothing for a channel: if the tvg-id is missing or doesn't match the guide data, there's nothing to connect it to.

Some playlists use the alternative names x-tvg-url or tvg-url for the same thing. VyraTV understands all three.

2. Xtream Codes guide data

If your provider uses Xtream Codes, the app can ask the provider's server for guide data directly – no separate guide link needed. Learn more in how to use Xtream Codes on iPhone.

How VyraTV loads the guide

You don't need to set anything up. When you add a playlist:

  • If it's an Xtream playlist, the guide comes from your provider automatically.
  • If it's an M3U playlist with a TV guide link (url-tvg), the playlist screen shows "This playlist includes a TV guide link. The guide is loaded automatically and shown under Favorites." The guide is then downloaded in the background.
  • If the playlist has neither, the app tells you that the guide is available when the playlist has a TV guide link (XMLTV) or comes from a provider with Xtream support. Ask your provider whether they offer guide data.

The guide is only as good as your provider's data. VyraTV doesn't supply or edit program information.

VyraTV is a player only. Channels and guide data come from your own playlist and provider – one you are authorized to use.

How to use the TV guide in VyraTV

The guide is built around the channels you care about – your favorites – so you're not scrolling through thousands of rows.

  1. Add a few channels to your favorites: tap the star next to a channel, or use Add to Favorites.
  2. Open the Favorites tab.
  3. Switch from List to Guide at the top.
  4. Each favorite channel shows what's on and what's next. The current program is marked On Now with a progress bar and how many minutes are left.
  5. To look ahead, pick a day (Today, Tomorrow and the days after) and a time such as 20:00. Tap Now to jump back to the present.
  6. Tap a program to expand it and read its description, if your provider includes one. Tap the channel to start watching.

The channels appear in the same order as your favorites. To change it, switch to List, tap Sort and use Move Up and Move Down, or Sort A–Z.

Set a program reminder

Don't want to miss something later tonight? Set a reminder:

  1. In the Guide view, find an upcoming program.
  2. Tap the bell next to it (Remind Me).
  3. The first time, allow notifications for VyraTV when iOS asks.
  4. You'll see Reminder Added: "You'll get a notification 5 minutes before the program starts." The notification shows the start time and the channel.

Tap the bell again to Remove Reminder. If you see Notifications Are Off, tap Open Settings and allow notifications for VyraTV in iPhone Settings.

Tip: Programs that already aired may show a Watch button, and the current one a Start Over button. That's catch-up – available when your Xtream provider keeps an archive. Read catch-up TV and Start Over.

Troubleshooting the TV guide

"No guide for this channel."

The guide data doesn't contain this channel, or the channel's tvg-id doesn't match. This is set by your provider – ask them to check the channel's guide mapping.

"Couldn't load the TV guide. Try again later."

The guide server didn't respond or the download was interrupted. Check your connection and try again later – large guides can take a moment to download.

The times look wrong

Guide times come from your provider's data. If every program is shifted by the same amount, the guide file probably has an incorrect time zone – your provider can fix that.

The guide stops after a day or two

Most guides only cover the next few days. When you reach the end you'll see "No more programs in the guide." Providers publish new guide data regularly, so check back later.

More questions? See VyraTV support.

See what's on, at a glance

Download VyraTV and get the TV guide from your own playlist.

Download on theApp Store Free for iPhone and iPad. Requires your own playlist.