EPG Guide: What Is Electronic Program Guide?

EPG (Electronic Program Guide) is the on-screen TV guide that shows what's playing now and next on each channel. It displays channel schedules in a grid format, similar to the program guide on cable TV. In IPTV, EPG is loaded from an external data source.

Understanding EPG helps you get the most out of your IPTV service. A properly configured program guide transforms the viewing experience from random channel surfing to organized, scheduled viewing.

What Is EPG?

EPG stands for Electronic Program Guide. It is the digital equivalent of a printed TV schedule. On your screen, it appears as a grid showing channels on the left and time slots across the top.

Each cell in the grid shows the program name, start time, end time, and often a brief description. You can scroll forward to see what's coming later today, tomorrow, or even a week ahead.

What EPG Shows You

• Program name — the title of the show or movie.
• Start and end times — when the program airs.
• Description — a short summary of the episode or film.
• Genre/category — sports, news, entertainment, kids, etc.
• Episode info — season and episode numbers (when available).
• Now/Next indicators — what's playing now and what's coming up.

Most leading IPTV providers include EPG data with their subscriptions at no extra cost.

How EPG Works in IPTV

In IPTV, EPG data comes from an external source — not from the broadcast signal. Traditional cable TV embeds guide data in the broadcast. IPTV downloads it separately from a URL.

Here is the process:

1. Provider hosts EPG data — schedule information is compiled into an XML file.
2. Player downloads the file — your IPTV app fetches the EPG URL on a schedule (usually every 12-24 hours).
3. Channel matching — the player matches EPG entries to channels using tvg-id identifiers.
4. Grid display — the matched data is displayed in the on-screen program guide.

EPG and Connection Methods

If you use Xtream Codes API, EPG is handled for you. With M3U playlists, you need to add the EPG URL separately.

EPG Formats: XMLTV & JTV

XMLTV is the standard EPG format used by most IPTV players. It is an XML-based file containing structured program data. JTV is an older, less common format.

XMLTV Format

XMLTV files use a structured XML format. Here is a simplified example:

<tv>
  <channel id="bbc1.uk">
    <display-name>BBC One</display-name>
    <icon src="https://example.com/bbc1.png" />
  </channel>
  <programme start="20260225080000" 
             stop="20260225090000" 
             channel="bbc1.uk">
    <title>BBC Breakfast</title>
    <desc>Morning news program.</desc>
    <category>News</category>
  </programme>
</tv>

Key XMLTV Elements

• <channel> — defines a channel with its ID, name, and logo.
• <programme> — defines a single show with start/stop times.
• channel attribute — links the program to a channel via matching IDs.
• <category> — genre classification.

How to Set Up EPG on Your Device

EPG setup depends on your connection method and player app. Here are instructions for the most common scenarios.

With Xtream Codes API

No extra steps needed. EPG loads automatically when you connect with your Xtream Codes credentials. If the guide is empty, go to your player's EPG settings and tap Refresh EPG.

With M3U Playlist

1. Get the EPG URL from your IPTV provider (usually ends in .xml or .xml.gz).
2. Open your player's Settings → EPG section.
3. Paste the EPG URL in the EPG Source field.
4. Set the Update Interval to 12 or 24 hours.
5. Tap Update/Refresh and wait for the data to download.

By Device

• Firestick — TiviMate and Smarters have EPG built into playlist settings. See our Firestick setup guide.
• Android TV — most apps on Android TV support EPG natively.
• Samsung / LG TVs — Smart IPTV and Smarters have EPG options. Guides for Samsung and LG.
• Formuler boxes — MYTVOnline 2 handles EPG automatically. See our Formuler Z guide.

Best EPG Sources

The best EPG source is the one provided by your IPTV provider. It is pre-matched to their channel list and updates regularly. However, there are third-party options if you need alternatives.

Provider EPG (Recommended)

• Pre-matched to your channel list — no manual configuration.
• Updated automatically every 12-24 hours.
• Included with most top IPTV services.

Third-Party EPG Sources

• WebGrab+Plus — open-source EPG grabber for creating custom XMLTV files.
• TV Guide APIs — commercial EPG data services for specific regions.
• Community XMLTV files — free, user-maintained EPG files for popular channels.

EPG Troubleshooting Guide

EPG issues are usually caused by mismatched IDs or outdated data. Here are quick fixes for the most common problems.

❌ EPG Shows "No Data" for All Channels

• Confirm you have entered the correct EPG URL.
• Force a manual EPG refresh in your player settings.
• Wait 5-10 minutes for large EPG files to download completely.
• Check your internet connection — EPG files can be 10-50 MB.

❌ EPG Works for Some Channels But Not Others

• The tvg-id in your M3U file doesn't match the EPG source for those channels.
• Contact your provider to verify the correct EPG IDs.
• Some international channels may not have EPG data available.

❌ EPG Shows Wrong Times

• Check your device's timezone settings.
• Some players have a Time Offset setting in EPG options — adjust it to match your timezone.

❌ EPG Makes the App Slow

• Reduce the EPG data range to 2-3 days instead of 7.
• Clear old EPG cache in your player settings.
• On older devices, use a lighter player like XCIPTV which has lower memory usage.

Frequently Asked Questions