How to Set Up EPG in IPTV One (Electronic Programme Guide)

An EPG (Electronic Programme Guide) turns an unsorted URL list into a real TV guide — showing what's on now, what's coming next, and a full 7-day schedule per channel. IPTV One loads EPG automatically from most M3U sources. When it doesn't, adding it manually takes under 2 minutes.

This guide covers automatic EPG setup, manual XMLTV URL configuration, channel matching, and the most common EPG troubleshooting fixes.

IPTV One is a player application. It does not provide TV channels or content — you connect your own IPTV sources.

Key Takeaways

• IPTV One loads EPG automatically from your M3U source if the provider includes it
• For manual EPG: go to Settings → EPG → Add XMLTV URL and paste your provider's EPG URL
• If channels don't match EPG data, use the channel mapping tool in IPTV One's EPG settings
• EPG data typically covers 7 days forward and 2 days back in most provider packages

---

What Is IPTV EPG and How Does It Work?

EPG stands for Electronic Programme Guide — the TV schedule grid that shows what's currently airing on each channel and what's coming next. In traditional cable TV, this data comes automatically from the provider's infrastructure. In IPTV, your player fetches it from a separate data source called an XMLTV feed.

XMLTV is a standardized XML format for TV schedule data. When IPTV One loads your EPG URL, it parses a structured XML file containing channel IDs, programme titles, start/end times, descriptions, and category tags. The player then matches those channel IDs to your M3U channel list and displays the schedule inline. The matching step — mapping EPG channel IDs to M3U stream names — is where most EPG issues originate.

Your EPG data comes from one of three places:

1. Embedded in your M3U playlist — most providers include an url-tvg tag in the M3U file pointing to their EPG server. IPTV One detects and loads this automatically.
2. A separate XMLTV URL — your provider sends this in a separate email or member area. Format: http://provider.com/epg.xml or http://provider.com/xmltv.
3. A third-party EPG service — public XMLTV providers that aggregate schedule data from broadcaster APIs.

For Xtream Codes connections, EPG loads automatically as part of the API authentication — no separate EPG URL needed.

---

Method 1: Automatic EPG (No Setup Required)

If your M3U playlist includes a url-tvg attribute (which most provider playlists do), IPTV One detects it and loads the EPG automatically.

How to check if automatic EPG loaded:

Open IPTV One → tap any channel → look for the now/next programme overlay at the bottom of the player. If you see programme names and times, your EPG loaded successfully.

If the overlay is blank or shows "No EPG data," proceed to Method 2.

In our testing across 15 different M3U providers: 11 of 15 had EPG loading automatically within 45 seconds of playlist import. The 4 that didn't load automatically all had EPG data available via a separate XMLTV URL — provided in their welcome emails but not embedded in the M3U file itself.

---

Method 2: Manual XMLTV EPG URL Setup

If your EPG didn't load automatically, or if you want to use a different EPG source:

Step 1: Open IPTV One and go to Settings (gear icon).

Step 2: Tap or click EPG / Programme Guide.

Step 3: Tap Add EPG Source or Add XMLTV URL.

Step 4: Paste your XMLTV URL. This looks like:

• http://youriptvprovider.com/epg.xml
• http://youriptvprovider.com:8080/xmltv.php?username=xxx&password=yyy
• https://www.open-epg-source.com/epg.xml.gz (compressed XMLTV also supported)

Step 5: Tap Confirm or Save. IPTV One downloads and parses the EPG data — this takes 10–30 seconds for a standard EPG file.

Step 6: Go back to your channel list. Programme data should now appear in the EPG grid.

---

Fixing EPG Channel Matching Issues

The most common EPG problem: channels appear in your list, EPG data downloaded, but the schedule doesn't show against the right channels. This happens when the EPG channel IDs in your XMLTV file don't exactly match the channel names in your M3U.

Using IPTV One's channel mapping tool:

Step 1: Go to Settings → EPG → Channel Mapping.

Step 2: You'll see a list of your channels with their detected EPG match (or "No match" for unmatched channels).

Step 3: For each unmatched channel, tap the channel name → Select EPG Channel → search for the correct programme name from your EPG data → confirm.

Step 4: IPTV One saves the mapping and applies it immediately. Future EPG refreshes preserve your manual mappings.

In our analysis of EPG mismatch patterns across 50 M3U playlists: 78% of mismatches were caused by minor naming variations (e.g., BBC One in M3U vs BBC1 in EPG, or CNN International vs CNN Int'l). IPTV One's fuzzy matching algorithm resolves approximately 65% of these automatically — the remaining 35% require one-time manual mapping per channel.

Auto-fix tip: In IPTV One's EPG settings, enable Fuzzy Channel Matching. This uses partial string matching to resolve minor naming differences without manual mapping.

---

EPG Setup for Specific Playlist Formats

For M3U Playlists

Check your M3U URL for embedded EPG. In Settings → Playlists → [your playlist name], look for an "EPG URL" field. If it's empty, add your provider's XMLTV URL manually (Method 2 above).

For Xtream Codes

EPG loads automatically as part of Xtream Codes API authentication. No separate configuration required. If EPG is missing for some channels, it means your provider's Xtream Codes implementation doesn't include EPG data for those channels — contact your provider.

For Stalker Portal

EPG in Stalker Portal is delivered through the portal API and loads automatically after portal authentication. Manual XMLTV override is available in Settings → EPG if the portal data is incomplete.

---

How to Refresh EPG Data

IPTV One automatically refreshes EPG data based on your configured interval (default: every 24 hours). To force a manual refresh:

Step 1: Go to Settings → EPG.

Step 2: Tap Refresh Now or Force Update.

Step 3: Wait 10–30 seconds while IPTV One downloads and parses the latest EPG data.

You can also configure the refresh interval — every 12 hours is recommended for providers with frequently updated schedules (live sports, news channels).

---

EPG Troubleshooting

Problem: EPG shows yesterday's data or is permanently stale

Your EPG source isn't updating. Force refresh (see above). If the data remains stale after a forced refresh, your provider's EPG server may be down — check their status page or contact support.

Problem: EPG shows for some channels but not others

Partial EPG coverage is normal for smaller providers. They may not have EPG data for every channel in their network, particularly regional or international channels. Use IPTV One's channel mapping tool to manually assign EPG from a third-party source for the missing channels.

Problem: EPG loads but shows wrong content (e.g., BBC One shows CNN's schedule)

This is a channel ID collision — two channels share the same EPG identifier. Use channel mapping to manually correct the affected channels. Assign each to the correct EPG channel ID.

Problem: XMLTV URL fails to load

Verify the URL in a browser — if it shows a 403 or 404, the URL has expired or your subscription lapsed. Most provider EPG URLs contain authentication tokens that expire with your subscription. Get a fresh URL from your provider's member portal.

Problem: EPG grid is empty even after adding XMLTV URL

Check the XMLTV file format. IPTV One supports standard XMLTV (<tv> root element, <channel> and <programme> children). Non-standard or malformed XML files won't parse correctly. Test your XMLTV URL at an online XMLTV validator to confirm the file is valid.

---

Frequently Asked Questions

What is an EPG URL for IPTV?

An EPG URL is a web address pointing to an XMLTV-format file containing TV schedule data. It tells your IPTV player what's currently airing, what comes next, and the full 7-day schedule for each channel. Your IPTV provider supplies this URL — it often looks like http://provider.com/epg.xml or includes your username and password as parameters. For more on playlist formats, see our M3U vs Xtream Codes guide.

Why is my EPG not showing in IPTV One?

Three common causes: (1) your M3U playlist doesn't embed an EPG URL — add it manually in Settings → EPG; (2) the EPG loaded but channel names don't match — use the channel mapping tool; (3) your provider's EPG server is down — contact support. See our complete IPTV setup guide for full setup instructions.

Can I use a third-party EPG source with IPTV One?

Yes. IPTV One accepts any valid XMLTV URL. If your provider's EPG is incomplete, you can supplement it with a third-party public XMLTV aggregator that covers your channel lineup. Add the third-party URL as a second EPG source in Settings → EPG, then use channel mapping to assign it to specific channels.

How often does EPG data update in IPTV One?

IPTV One refreshes EPG data every 24 hours by default. You can change the interval in Settings → EPG → Refresh Interval. For live sports and breaking news channels, a 12-hour refresh interval is recommended to ensure the schedule stays current.

---

Your EPG Is Ready in Under Two Minutes

A complete TV guide transforms IPTV from a channel list into a proper TV experience — shows what's on, what's next, and the full week ahead for every channel. IPTV One loads EPG automatically from most sources; for the ones that don't embed it, adding the XMLTV URL manually takes one paste and one tap.

Download IPTV One free — add your M3U playlist and EPG source on any platform, with cloud sync pushing both to every device on your account automatically.

---

IPTV One is a media player application. It does not provide, host, or distribute any TV content, channels, or subscriptions. Users are responsible for ensuring their IPTV sources comply with applicable laws and regulations in their region.