How to Convert M3U Playlist to XMLTV EPG File (2026 Guide)

Your M3U playlist gives you access to thousands of live TV channels. But without an EPG file, you are flipping through a blank guide. Every channel number shows “No Information.” You have no idea what is playing now or next. Converting your M3U playlist to an XMLTV EPG file fixes that. It turns your raw channel list into a full TV guide with program schedules, descriptions, and accurate timings. This guide walks you through the process in five steps. You do not need coding experience. You just need your playlist URL, a free tool, and about 20 minutes.

What You’ll Need to Convert M3U to XMLTV

Before you start, gather these items. Having everything ready makes the conversion smooth.

• Your M3U playlist URL or file — Most providers give this in your account dashboard. If you use Perfect IPTV, your playlist URL is available immediately after purchase through the Xtream Codes API or direct M3U link.
• A web browser — Chrome, Firefox, or Edge all work for online tools.
• A text editor — Notepad++ or VS Code for inspecting your playlist if needed.
• An EPG source or generator tool — Options include EPG.Best, iptv-epg.org, or the EPG Builder tool at yerman.uk. We cover these in Step 2.
• Your IPTV player ready — TiviMate, IPTV Smarters Pro, or Smart IPTV. These players all accept external XMLTV EPG URLs.

That is it. No special hardware. No paid software. Most of the tools are free. If your provider offers built-in EPG already, you may skip the conversion entirely. But many providers — especially smaller ones — do not supply reliable guide data. That is when this method becomes essential.

Trial Pass

Step 1: Understand Your M3U Playlist Structure

An M3U playlist is a plain-text list of your channels. Each entry has an #EXTINF line followed by the stream URL. The #EXTINF line contains attributes like tvg-id, tvg-name, tvg-logo, and group-title. These attributes tell your player how to display and organize channels.

Here is what a typical entry looks like:

#EXTINF:-1 tvg-id="bbcone.uk" tvg-name="BBC One" tvg-logo="https://example.com/logos/bbcone.png" group-title="UK Entertainment",BBC One
http://stream.example.com/live/bbcone.ts

The most important attribute for EPG mapping is tvg-id. This is the unique identifier that connects your channel to its program data in the XMLTV file. Without a correct tvg-id, your player cannot match the channel to the schedule. If your M3U playlist does not have tvg-id entries, you will need to add them manually or use a tool that auto-matches channel names.

Open your playlist in a text editor. Scroll through and check whether your channels have tvg-id attributes. If they do, great. Write them down or keep the file open. If they do not, you can still proceed — the mapping step will handle it. Pro tip: Many IPTV providers like Perfect IPTV include tvg-id in their M3U Plus format. Check the pricing page to see which plans include full M3U Plus playlists with embedded ID tags.

Take note of the channel names as they appear in your playlist. These names need to match — or closely resemble — the channel names in your EPG source. For example, if your playlist calls it “BBC One HD” but the EPG calls it “BBC One,” you may need to adjust either the playlist name or the EPG mapping.

Step 2: Choose Your EPG Source or Generator

You need an XMLTV file that contains program data for your channels. You have three options here.

Perfect IPTV UK Pricing Plan

Option A: Use a Public EPG Repository

Several free repositories offer XMLTV files by country. Websites like iptv-epg.org and open-epg.com provide daily-updated EPG files for hundreds of channels across dozens of countries. Find your country, download the .xml or .xml.gz file, and note the URL. This is the easiest method if you watch mainstream channels from the UK, US, Germany, France, or other well-covered regions. For UK users, the Freeview EPG data covers BBC, ITV, Channel 4, Sky channels, and more.

Option B: Use an EPG Builder Tool

Online tools like the EPG Builder at yerman.uk let you paste your M3U playlist and generate a custom XMLTV file. These tools scan your channel list, match channel names against their EPG database, and output a filtered XMLTV file containing only the programs for your specific channels. This is the best middle ground. You get a smaller, faster file without extra junk channels you do not watch.

Option C: Build Your Own Using Python

If you have some technical comfort, open-source Python scripts like the IPTV EPG Generator on GitHub can pull data from multiple XMLTV sources, merge them, and filter by your channel list. This option gives you full control. You can schedule it with cron or Task Scheduler to regenerate your EPG daily. It requires Python 3.7 or higher and basic command-line skills.

For most users, Option B provides the best balance of simplicity and accuracy. You can start your free trial of Perfect IPTV and test the EPG Builder with your live playlist to see how well the channel matching works before committing to a full subscription.

Step 3: Map tvg-id to Your XMLTV Channels

This is the most critical step. The mapping connects each channel in your M3U playlist to its corresponding entry in the XMLTV file. The connection uses the tvg-id attribute.

Limited Time Offers

Here is how to do it:

1. Open your M3U playlist and note the tvg-id for each channel. If your playlist lacks tvg-id, the channel name becomes your matching key.
2. Open your XMLTV file (or check the EPG source website) and find the channel id values. In an XMLTV file, each channel looks like this: <channel id="bbcone.uk">. The id attribute must match the tvg-id in your M3U.
3. If the IDs do not match, edit your M3U playlist’s tvg-id to match the XMLTV channel id. Or use an EPG Builder that does this matching automatically by channel name.
4. Some EPG tools also support tvg-name matching. If your channel is “BBC One HD” and the EPG has “BBC One,” the tool may still match them if the names are close enough.

A mismatch here is the number one reason EPG shows “No Data.” Double-check your IDs. Most IPTV players, once the mapping is correct, will display the EPG within 30 seconds of loading the guide. If you use a reseller plan from Perfect IPTV, you can set up a single master mapping and reuse it across all your client playlists, saving hours of manual work.

Step 4: Generate the XMLTV EPG File

With your mapping ready, it is time to generate the actual XMLTV file. The exact method depends on the tool you chose in Step 2.

Using an Online EPG Builder

1. Go to your chosen EPG Builder website (e.g., yerman.uk/epg-builder).
2. Paste your M3U URL or upload your M3U file. Most tools support both options.
3. Select your country or EPG region. This filters the program data to relevant channels.
4. Click “Generate” or “Build EPG.” The tool scans your channels and matches them against its database.
5. Download the resulting XMLTV file or copy the generated URL. Some tools give you a static URL that updates automatically every day.
6. Test the file by opening it in a browser or text editor. You should see <channel> and <programme> entries for each of your channels.

Using a Python Script

1. Clone the repository: git clone https://github.com/indakabarody/iptv-epg-generator
2. Install dependencies: pip install -r requirements.txt
3. Create a mapping.json file listing your channels and their tvg-ids.
4. Add your EPG source URLs to epg_sources.json.
5. Run the script: python update_m3u.py. The output is a filtered XMLTV file with only your channels’ program data.
6. Set up a daily cron job or Task Scheduler trigger so the script regenerates the EPG automatically.

Regardless of the method, the output is a standard XMLTV file. Most IPTV players accept both .xml and .xml.gz formats. The gzipped version loads faster because it is smaller. If your player supports compressed files, use the .gz version.

Step 5: Host and Link the EPG in Your Player

Your XMLTV file is ready. Now you need to make it accessible to your IPTV player. You have two options.

Option A: Host the File on a Web Server

Upload your XMLTV file to any web-accessible location. Free options include GitHub Gist, Dropbox public links, Netlify, or even a free hosting service. Once uploaded, you get a direct URL that ends in .xml or .xml.gz. Copy this URL. This is your EPG URL. Most online EPG Builder tools already provide a hosted URL for you, so you can skip this step.

Option B: Use a Local File

If you only watch IPTV on one device, you can save the XMLTV file directly to your device and point your player to the local file path. In TiviMate, go to Settings > EPG > Source > Local file and select the downloaded .xml file. This works but does not update automatically. You would need to re-download and replace the file each time you want fresh guide data.

Linking in Your Player

In TiviMate: Open Settings > EPG > EPG Source > Add Source > enter your EPG URL. Make sure “Update automatically” is enabled. In IPTV Smarters Pro: Go to Settings > EPG URL > paste your link > Save. In Smart IPTV: Go to Settings > EPG Source URL > enter your URL. The player will fetch the EPG data immediately or on its next update cycle. Within a minute, your guide should display program names, start times, descriptions, and categories for every mapped channel. If you are setting this up on an Amazon Firestick, ensure your internet connection is stable during the initial EPG load. The first download can take 10-30 seconds depending on file size.

What to Do If Something Goes Wrong

EPG conversion is not always perfect on the first try. Here are the most common issues and how to fix them.

Issue 1: “No Data” on All Channels

This usually means the EPG URL is wrong or the player cannot reach it. Test the URL in a browser. If it downloads, the URL works. If it does not, regenerate the file and re-upload it. Also check that your player’s EPG update interval is set to a reasonable value — try manual update first.

Issue 2: Some Channels Show Data, Others Don’t

The tvg-id in your M3U does not match the channel id in your XMLTV file. Open your XMLTV, search for the channel that is missing data, and compare its id to the tvg-id in your M3U playlist. Edit one to match the other. If you are using an EPG Builder, check whether the tool’s auto-matching missed that channel. You may need to manually assign tvg-id in the builder’s interface.

Issue 3: EPG Shows Wrong Times

This is a timezone issue. XMLTV files usually store times in UTC format. Your player must know your local timezone. In TiviMate, go to Settings > EPG > Time Offset. Set it to your UTC offset. For UK users during BST, that is +1. For US Eastern, that is -4 or -5 depending on daylight saving. If your XMLTV file itself has wrong timestamps, the EPG source is the problem — switch to a different EPG repository.

Issue 4: Player Feels Slow After Adding EPG

Large XMLTV files can slow down older devices like first-generation Firesticks. Use a filtered EPG that contains only your channels. The EPG Builder tools and Python scripts both produce filtered output. Also enable the .gz compressed format if your player supports it — smaller files load faster.

Issue 5: EPG Stops Updating After a Few Days

Your EPG URL may have expired. Free hosted URLs from some tools expire after 24-48 hours. Use a permanent URL from a service that offers daily updates. Alternatively, host the file yourself on a service you control. Contact support on WhatsApp if you are using Perfect IPTV and your EPG stops working — the team can help troubleshoot your setup.

Pro Tips for Best Results

Automate Your EPG Updates

Manually regenerating your EPG every day is tedious. Most EPG Builder tools offer automatic daily updates if you use their hosted URL. For Python-based solutions, set a cron job (Linux/Mac) or Task Scheduler (Windows) to run the script every 24 hours. Schedule it for early morning — around 3 AM — so fresh guide data is ready when you wake up.

Use Multiple EPG Sources

One EPG source may not cover all your channels. Some tools let you merge multiple XMLTV files. You can combine a UK Freeview EPG with a sports-specific EPG and an international channel EPG into one master file. The Python IPTV EPG Generator script supports merging multiple sources from a JSON configuration. Include the epg_sources.json entries for each source and the script handles the merge automatically.

Standardize Your tvg-id Naming Convention

If you manage multiple playlists — for example, as a reseller — use a consistent tvg-id naming convention across all your M3U files. This lets you reuse a single XMLTV file for all your clients. The convention ChannelName.CountryCode (e.g., BBCOne.uk, CNN.us) is widely adopted and avoids ID conflicts. Perfect IPTV uses standard IDs that are compatible with most public EPG repositories.

Reduce File Size by Filtering

A full country EPG file can contain 500+ channels. If you only watch 50 of them, you are downloading 10x more data than needed. Filter your XMLTV to include only your channels. This makes your EPG load in 3 seconds instead of 30. The EPG Builder tools and mapping.json filter in the Python script both achieve this automatically.

Test with a Free Trial First

Before committing to a provider, test your EPG setup with a free trial. Perfect IPTV offers a 3-hour free trial with no card required. Use that time to test your M3U-to-XMLTV conversion with a live playlist. If the EPG works well with their channel lineup, you know your setup is solid. You can also try the 3-day trial for £3 for extended testing across a full weekend of programming.

Frequently Asked Questions

What is an XMLTV file?

An XMLTV file is an XML document that contains TV program schedules. It lists channels, program titles, start and end times, descriptions, categories, and other metadata. IPTV players use it to display an electronic program guide. The format was developed in 1999 and is now the industry standard for IPTV EPG data.

Do I need XMLTV if my provider already has EPG?

Not necessarily. Some providers include EPG data alongside their M3U playlist or through Xtream Codes API. If your provider’s EPG shows accurate data for all channels, you do not need to convert anything. But many providers supply incomplete or incorrect EPG data. Converting your M3U to XMLTV using a separate, reliable EPG source often produces better results.

What is tvg-id and why does it matter?

tvg-id is an attribute in your M3U playlist that identifies a channel for EPG matching. It acts like a foreign key that links the channel in your playlist to its program data in the XMLTV file. If your tvg-id values do not match the channel id values in the XMLTV file, the player cannot display guide data for those channels.

Can I convert M3U to XMLTV online for free?

Yes. Free online tools like the EPG Builder at yerman.uk, EPG Editor, and iptv-epg.org let you generate XMLTV files from your M3U playlist at no cost. Some tools limit the number of channels or require accounts for advanced features, but basic conversion is free across most platforms.

How often should I update my XMLTV EPG file?

Daily updates are ideal. TV schedules change every day. Most public EPG repositories update their files once every 24 hours. If your EPG is more than 48 hours old, some channels may show outdated or incorrect information. Use tools that offer automatic daily regeneration.

Does M3U to XMLTV conversion work for VOD channels?

No. XMLTV is designed for live TV schedules with start and end times. Video-on-demand content does not have a linear schedule. Some IPTV players handle VOD separately in a dedicated section. Your EPG conversion should focus only on live TV channels.

What IPTV players support external XMLTV EPG?

TiviMate, IPTV Smarters Pro, Smart IPTV, GSE Smart IPTV, VLC, Kodi, Jellyfin, Plex, Emby, and TVHeadend all support external XMLTV EPG sources. Each player has a settings section where you can paste the URL to your XMLTV file. Some players also support local file import.

My EPG shows programs but the channel logos are missing. Why?

Channel logos come from the tvg-logo attribute in your M3U playlist, not from the XMLTV file. Check that your M3U entries include a valid tvg-logo URL pointing to the logo image. If the logos are missing, add the tvg-logo attribute to each channel line in your playlist.

Can I use one XMLTV file for multiple devices?

Yes. Host the XMLTV file on a web server and use the same URL across all your devices — Firestick, Android TV, smartphone, laptop. Each device fetches the same guide data independently. This is the most efficient setup for households with multiple IPTV devices.

What happens if my IPTV provider changes the channel lineup?

New channels added by your provider will not have EPG data until you regenerate the XMLTV file with their tvg-id included. Remove deprecated channels from your mapping to keep the file clean. If you use an EPG Builder that pulls directly from your M3U URL, any changes to your playlist are reflected automatically on the next regeneration.

Conclusion

Converting an M3U playlist to an XMLTV EPG file transforms your IPTV experience from a blind channel list into a proper TV guide. You get program titles, descriptions, categories, and accurate timings for every channel. The process takes about 20 minutes and costs nothing beyond your IPTV subscription. Start with a reliable provider that includes tvg-id in their M3U Plus playlists. Map your channels once. Automate the daily regeneration. And enjoy a complete TV guide on every device. If you need help with the setup, message us on WhatsApp — the Perfect IPTV team is available 24/7.

Ready to test your EPG setup? Start your free trial of Perfect IPTV with 9,000+ live channels and built-in M3U Plus support. No card required. Instant activation.