I remember the first time I tried to set up an IPTV service without an EPG. It was frustrating. I had hundreds of channels. But I had no idea what was playing on any of them. Channel names like “UK Sports 1” and “USA Movies HD” told me nothing. I spent more time clicking through channels than actually watching anything.
Then I discovered EPG. Electronic Program Guide. It changed everything. Suddenly I could see what was playing now. What was coming up next. What was on later tonight. Just like a real TV guide.
This guide explains what XMLTV EPG is, where to find it, how to set it up, and how to fix it when it breaks. No technical degree required.
Part of our guide to IPTV Guides
Also see: What is IPTV? → | M3U Playlist Guide → | Best IPTV Players →
The Short Answer
EPG stands for Electronic Program Guide. It is the on screen guide that shows you what is playing on each channel. You know the one. Grid of channels on the left. Times across the top. Show titles in the middle. That is an EPG.
XMLTV is a specific format for EPG data. It is an XML file that contains program schedules. Your IPTV player reads this file and displays the guide on your screen [citation:3].
Without an EPG, your IPTV player shows you channel names and nothing else. You click on a channel to see what is playing. With an EPG, you see everything at once. What is on now. What is on later. What time your favorite show starts. It is essential for a good IPTV experience.
Most legal IPTV services include EPG data automatically. You do not have to do anything. The guide just works. For technical setups or custom playlists, you may need to add an EPG source manually.
Why You Need an EPG for IPTV
Imagine walking into a library with no labels on the shelves. No signs. No organization. Just thousands of books in random order. That is what IPTV is like without an EPG.
An EPG gives you structure. You can see at a glance what is on every channel. You can plan your viewing. You can set reminders for shows you do not want to miss. You can record programs if your player supports it [citation:7].
Here is what a good EPG gives you:
Channel and program information: The name of the show. The start time. The end time. A description of the episode. Sometimes the season and episode number. Sometimes the actors and directors.
Visual navigation: A grid layout that makes sense. You scroll through channels vertically. You scroll through time horizontally. You see everything at once.
Search and filter: Find all sports programs. Find all movies. Find a specific show across all channels. Without an EPG, this is impossible.
Recording and reminders: If your IPTV player supports DVR features, the EPG tells it when to record. You click record on a show. The player uses the EPG data to know when the show starts and ends.
Every legal IPTV service includes an EPG. YouTube TV has one. Hulu Live has one. Sling TV has one. They would be unusable without it. For custom IPTV setups, you need to add your own EPG source.
How XMLTV EPG Works
XMLTV is a standard format for TV listings. It was created in the early 2000s and has been used ever since. The format is simple. An XML file with a specific structure that IPTV players can read [citation:3].
The file contains three main types of information.
Channel information: Each channel in your playlist needs an ID. The EPG file uses the same ID to match program data to the right channel. If the IDs do not match, the guide will be empty for that channel.
Program information: Each program has a title, a start time, an end time, and a description. The start and end times are in UTC, which means you may need to adjust for your time zone.
Schedule data: The file lists programs in chronological order. The IPTV player reads this and displays the guide. Most EPG files cover several days or weeks of programming.
Here is what a real XMLTV entry looks like [citation:8]:
<channel id="BBC One"> <display-name>BBC One</display-name> </channel> <programme start="20260329190000 +0000" stop="20260329200000 +0000" channel="BBC One"> <title>BBC News at Ten</title> <desc>The latest national and international news.</desc> </programme>
The start time means March 29, 2026, at 19:00 UTC. The stop time means 20:00 UTC. The channel ID matches the channel in your playlist. The title and description are what you see in the guide.
You do not need to understand the code. Your IPTV player handles the technical details. You just need to give the player a web address where the XMLTV file lives.
Where to Find XMLTV EPG Sources
If you are using a legal IPTV service, you do not need to find an EPG source. The service provides it automatically. The guide just works.
If you are setting up a custom IPTV playlist, you have several options.
Free EPG sources: There are websites that provide free XMLTV data. Some are reliable. Some are not. EPG Guide and WebGrab Plus are popular options. The data quality varies. Some channels have accurate listings. Others have outdated or missing information.
Paid EPG sources: For reliable data, paid EPG services are better. They cost a few dollars per month. The data is more accurate. The coverage is more complete. Support is available if something breaks.
Built-in EPG from your IPTV provider: Many IPTV providers include EPG data with their service. They give you an M3U playlist and an XMLTV URL. You put both into your IPTV player. The guide populates automatically.
Community maintained EPG files: Some forums and GitHub repositories host EPG files created by volunteers. These are free but not always reliable. They may stop working without notice.
Before you pay for an EPG source, check if your IPTV provider already includes one. Many do. The URL usually looks something like http://your-iptv-provider.com/epg.xml. Ask your provider for the link.
How to Add XMLTV EPG to Your IPTV Player
The steps vary depending on your IPTV player. But the basic process is the same for most players.
Using IPTV Smarters Pro:
Open the app. Go to Settings. Look for EPG or Program Guide. Enter the XMLTV URL. Save. The app downloads the EPG data. Wait a few minutes. The guide populates.
If you are setting up from scratch, add both your M3U playlist and your XMLTV URL during the initial setup. Most players have a field for each [citation:7].
Using TiviMate:
Open TiviMate. Go to Settings > Playlists. Select your playlist. Scroll down to EPG sources. Add the XMLTV URL. Go back to the main screen. The guide should appear.
TiviMate is one of the best IPTV players for EPG support. It handles multiple EPG sources. It lets you assign channels manually if the automatic matching fails.
Using VLC Media Player:
VLC does not support EPG. You will not get a program guide. Use a dedicated IPTV player instead. VLC is great for playing individual streams. It is not good for channel surfing.
Using Smart IPTV on Smart TV:
Open the Smart IPTV app. Go to Settings. Look for EPG URL. Enter the XMLTV link. Save. Restart the app. The guide should appear after a few minutes.
After adding the EPG source, give it time. The first download can take a few minutes depending on the file size. Some EPG files are hundreds of megabytes. Be patient.
How to Create Your Own XMLTV EPG File
Creating your own EPG file is possible. It is not easy. But for advanced users who want full control, it is an option.
Option one, use WebGrab Plus: This is free software that grabs TV listings from websites and converts them to XMLTV format. You configure it with the websites you want to grab from. It runs on your computer. You schedule it to run daily. The output is an XMLTV file you can host on a server [citation:8].
The learning curve is steep. You need to understand configuration files. You need to know which websites have the data you want. You need a place to host the generated file.
Option two, use EPG Editor software: There are paid tools that help you create and edit EPG files. They have graphical interfaces. You do not need to write code. You point and click to add programs. You drag and drop to set times.
These tools are useful for small channel lists. If you only have a few dozen channels, manual editing is manageable. For hundreds of channels, automated tools are better.
Option three, write a script: If you know how to code, you can write a script that generates XMLTV files. You pull data from APIs. You format it as XML. You host the file on a server.
This is the most flexible option. It is also the most work. Only do this if you have programming experience and a specific need that existing tools do not meet.
Option four, use a local EPG generator for your own channels: If you have created your own IPTV channels from files on your hard drive, you can generate a simple EPG using the XMLTV format. Several open-source tools are available for this purpose [citation:8].
For most people, creating your own EPG is not worth the effort. Use a free or paid EPG source instead. Let someone else do the work.
Common EPG Problems and How to Fix Them
After years of using EPG with IPTV, I have seen every problem possible. Here are the most common issues and how to fix them.
The EPG is empty or shows no data: First, check that you entered the URL correctly. One wrong character breaks everything. Second, check that the URL works. Open it in a browser. If you see XML code, the URL is valid. If you get an error, the URL is broken. Third, check channel ID matching. Your playlist channel IDs must match the EPG channel IDs. If they do not, the guide will be empty [citation:3].
Program times are wrong (off by hours): This is a time zone issue. EPG data is often in UTC. Your IPTV player might be using your local time. Go to EPG settings. Look for time offset or time zone adjustment. Add or subtract hours until the times match [citation:3].
For example, if your guide shows programs starting four hours later than they actually start, subtract four hours. If they start earlier, add hours. The exact offset depends on your time zone and the EPG source.
Some channels have data, others do not: Your EPG source does not cover all channels. That is common. Free EPG sources have gaps. Check the EPG file in a text editor. Search for the channel names that are missing. If they are not in the file, the EPG source does not cover them. You need a different EPG source for those channels.
Some IPTV players let you use multiple EPG sources. Add a second source to fill the gaps. The player will combine data from both sources.
The EPG is outdated or missing current programs: Your EPG file is not updating. Check that your IPTV player is set to refresh EPG data regularly. Most players have an auto update setting. Set it to refresh every 24 hours. If the problem continues, the EPG source itself is not updating. Find a different source.
EPG data is in the wrong language: Some EPG sources include multiple languages. Your IPTV player may have a language priority setting. Set your preferred language. The player will use that language when available [citation:3].
If your player does not have this setting, you need an EPG source that only has your language. Look for country specific EPG sources.
The EPG loads slowly: Large EPG files take time to download. Some files are hundreds of megabytes. If your player downloads the full file every time, it will be slow. Check if your player supports incremental updates. Some only download changes, which is much faster.
You can also try compressing the EPG file. Gzip compression reduces file size significantly. Many IPTV players support compressed EPG files. The URL would end with .xml.gz instead of .xml.
Legal IPTV Services with Built-in EPG
The easiest way to get a working EPG is to use a legal IPTV service. They include the guide automatically. No setup required.
YouTube TV: The EPG is excellent. Channel logos. Show descriptions. Episode information. Sports scores. It is as good as any cable guide. And it works on every device.
Hulu Live: The EPG is integrated into the Hulu interface. It works well. The channel grid is easy to read. The show descriptions are detailed. The only downside is that the interface is busier than YouTube TV.
Sling TV: The EPG is basic but functional. Channel logos. Show titles. Descriptions. Nothing fancy. But it works. And for the price, it is fine.
FuboTV: The EPG is sports focused. It shows scores. It shows game times. It shows which channel has which game. For sports fans, it is excellent. For general viewers, it is fine.
DirecTV Stream: The EPG feels like traditional cable. If you miss the old cable guide experience, this is for you. Channel numbers. Grid layout. Show descriptions. It is familiar.
All of these services work out of the box. You do not need to find XMLTV files. You do not need to configure anything. Just open the app and look at the guide. That is the experience most people want.
Frequently Asked Questions
What is the difference between M3U and XMLTV? M3U is the playlist. It lists the channels and their stream addresses. XMLTV is the program guide. It tells you what is playing on each channel. You need both for a complete IPTV experience.
Can I use EPG without M3U? No. The EPG needs channel IDs that match your playlist. Without a playlist, the EPG has nothing to attach to. They work together.
How often should EPG update? Once per day is usually enough. Some players update every few hours. Daily is fine for most users. Live sports may need more frequent updates.
Why does my EPG show the wrong program? The EPG source has incorrect data. There is nothing you can do except find a better EPG source. Paid sources are usually more accurate than free ones.
Can I use multiple EPG sources? Yes, many IPTV players support multiple EPG sources. They combine data from all sources. If one source is missing a channel, another source might cover it.
Is EPG data free? Some EPG sources are free. Some cost money. Free sources are less reliable. Paid sources are more accurate and have better coverage. Legal IPTV services include EPG at no extra cost.
Related guides: