IPTVGuide
Get Help
Updated for 2026 — Step-by-Step IPTV Guide

How to Map External EPG URL
to Raw M3U Playlist

Complete tutorial covering every method to map an external EPG URL to your raw M3U playlist — from tvg-id editing to TiviMate's built-in EPG assignment.

Last updated: June 2026  ·  ~10 minute read

What Is EPG and Why Does It Need Mapping?

EPG stands for Electronic Program Guide — the grid of TV shows and schedules that tells you what's playing on each channel. In IPTV, EPG data is delivered as an XML file hosted at a URL (like https://example.com/epg.xml).

A raw M3U playlist contains a list of channels, each with a tvg-id, tvg-name, and tvg-logo attribute. The EPG XML file also references channels by their channel id. For EPG to display correctly, the tvg-id in the M3U must match the channel id in the EPG XML.

When you get a raw M3U from a provider, the tvg-ids may use custom naming that doesn't align with your EPG source. You need to map the external EPG URL so that each channel in the M3U points to the correct EPG data.

The EPG Mapping Problem

Here's the core issue: channel names in the EPG XML must match channel names in the M3U playlist. If they don't, you'll see "No Information" or wrong show listings.

For example, your M3U might list a channel as:

#EXTINF:-1 tvg-id="espn-us" tvg-name="ESPN HD",ESPN HD

But your EPG XML uses the ID ESPN.us. The mismatch means you get no EPG data. Mapping solves this by aligning the two sources.

3 Ways to Map EPG to M3U

1

Use an M3U Editor with EPG Mapping

Tools: m3u.guide, M3U4U alternatives, strim

Online M3U editors let you upload or paste your raw M3U, then manually map each channel's tvg-id to match an external EPG source. These tools provide a visual interface for matching channels without editing files by hand.

2

Edit tvg-id Attributes Directly in the M3U

Manual editing with Notepad++ or any text editor

Open your raw M3U file in a text editor and modify the tvg-id="..." attribute on each channel line to match the channel ID from your EPG XML source. This gives you full control but requires manual work for large playlists.

#EXTINF:-1 tvg-id="bbc.one.london" tvg-name="BBC One London",BBC One London

Tip: Use find-and-replace with regex in Notepad++ or VS Code to batch-rename tvg-ids. Save the edited file and point your IPTV player to the modified M3U.

3

Use TiviMate's Built-in EPG Assignment

No file editing required — assign EPG directly inside TiviMate

TiviMate includes a powerful EPG assignment feature that lets you map channels manually or search for EPG sources without ever touching the M3U file. This is the easiest method for Firestick and Android TV users.

Step-by-Step: Map EPG in TiviMate

Follow these steps to assign EPG data to channels in TiviMate using an external EPG URL.

1

Long Press on a Channel

Open TiviMate and navigate to any channel that shows "No Information" in the EPG. Press and hold the OK/Select button on your remote until the context menu appears.

2

Channel Options > Assign EPG

From the context menu, select Channel Options, then choose Assign EPG. This opens the EPG assignment screen where you can search for the correct guide data.

3

Search for Channel Name

Use the search field to type the channel name (e.g., "CNN", "ESPN", "BBC"). TiviMate will show matching results from the EPG source you have configured in your playlist settings.

4

Select the Correct EPG Source

Browse the search results and select the EPG entry that matches your channel. If you have multiple EPG URLs configured, TiviMate will show sources from all of them. Confirm your selection.

5

Repeat for All Unassigned Channels

Go through each channel that lacks EPG data and repeat steps 1–4. You can speed this up by using the Assign EPG for All option if available, or batch-mapping channels with similar names.

Pro tip: Before starting, go to Settings > EPG > EPG Sources and make sure your external EPG URL is added and has finished updating. TiviMate will only show channels from EPG sources that have been successfully loaded.

Mapping EPG in IPTV Smarters

For IPTV Smarters Pro, EPG is typically mapped automatically if you use Xtream Codes API login. When you log in via Xtream Codes (rather than uploading an M3U file), the API delivers channel and EPG data together, so the mapping is handled server-side.

If you are using M3U URL login in IPTV Smarters, you can add an EPG URL in Settings > EPG > Add EPG URL. The app will attempt to auto-map channels based on tvg-id matching. For channels that still show "No Info", you can manually assign EPG by long-pressing the channel and selecting EPG options.

Frequently Asked Questions

What is an EPG URL and where do I get one? +
An EPG URL is a direct link to an XML file that contains TV schedule data. You can get a free EPG URL from sources like IPTV-ORG.github.io, epg.best, or from your IPTV provider. The URL usually ends in .xml or .xml.gz.
Can I use multiple EPG sources in TiviMate? +
Yes. TiviMate supports multiple EPG sources. Go to Settings > EPG > EPG Sources and add each URL. TiviMate will merge all EPG data and show results from every source when you use the Assign EPG feature.
Why does my EPG show "No Information" after mapping? +
This happens when the tvg-id in your M3U still doesn't match any channel ID in the EPG XML. Double-check the exact spelling, case sensitivity, and special characters. Some EPG providers use underscores where the M3U uses dots, or vice versa.
Does this work on Firestick and Android TV? +
Yes. TiviMate runs on Firestick and Android TV, and the Assign EPG feature works identically on both. For IPTV Smarters, the same mapping steps apply on Firestick, Android TV, iPhone, and Android phone.
What happens if my IPTV provider changes the channel IDs? +
If your provider updates the M3U with new tvg-ids, your manual EPG assignments may break. Use an M3U editor to maintain a custom mapping profile, or switch to Xtream Codes API which handles mapping server-side and is unaffected by M3U changes.

Stuck on EPG Mapping?

Message us on WhatsApp — we'll help you set up your EPG and M3U step by step. Free support for IPTV users.

Chat with us on WhatsApp

We'll help you map your EPG free of charge — no purchase needed

+216 23 179 016  ·  Available 24/7