IPTV Files Explained: M3U, M3U8 & EPG
IPTV files are plain-text playlists that tell your player where to find live TV streams. Learn how M3U, M3U8, and EPG files work and where to get them
IPTV files are plain-text playlists that list stream addresses your player uses to pull live TV from the internet. There is no video stored in the file itself, just URLs, channel names, and optional metadata.
Once you understand what these files contain and where to get reliable ones, setting up any IPTV app becomes straightforward. If you want to skip the file management entirely, Vivimate is a licensed IPTV provider that handles playlist delivery automatically, so your channels stay current without you touching a file.
What IPTV files actually contain
Open any .m3u file in a text editor and you will see two things repeated for every channel: a line starting with #EXTINF that carries the channel name and attributes, and a plain URL on the line below it.
Here is a minimal example:
#EXTM3U
#EXTINF:-1 tvg-id="bbc1" tvg-name="BBC One" group-title="UK",BBC One
https://example-stream-server.com/bbc1/index.m3u8That is the whole format. The player reads the name from #EXTINF, then connects to the URL. If the URL is live and accessible, the channel plays. If it is dead or geo-blocked, it fails.
M3U vs M3U8
The two extensions refer to the same playlist format. M3U8 just signals that the file uses UTF-8 encoding, which matters when channel names include non-Latin characters. For practical purposes, most players accept both extensions interchangeably.
Attributes you will see
- tvg-id: Links the channel to an EPG entry so your player can show programme schedules.
- tvg-logo: A URL pointing to the channel’s logo image.
- group-title: The category label, like “Sports” or “News”, that players use to sort channels into folders.
None of these attributes are required. A bare URL with a name works. The attributes just make the experience better inside the app.
Types of IPTV files and when you need each
Playlist files (.m3u / .m3u8)
This is what people mean when they say “IPTV file.” It is the channel list. Every IPTV setup starts here. You either paste a URL that points to a hosted version of this file, or you download the file itself and load it locally.
Hosted URLs are more practical. When your provider updates stream addresses, the hosted file reflects the change immediately. A downloaded local copy goes stale the moment anything on the server side changes.
EPG files (.xml / .xmltv)
Electronic Program Guide files are separate from the playlist. They are XML documents containing schedule data: what is on, when, and on which channel. Your player cross-references the tvg-id in the M3U against the channel IDs in the EPG to populate the guide grid.
You load the EPG file or its URL in your player’s settings, usually in a separate field from the M3U. Apps like TiviMate and IPTV Smarters both support this two-file approach.
If your provider does not supply an EPG URL, the easiest path is a licensed provider like Vivimate, which includes EPG data as part of the subscription so you do not need to source or maintain it separately.
Catch-Up and VOD files
Some providers extend the M3U format with extra tags that enable catch-up TV or video-on-demand libraries. These are still plain-text files, just with additional metadata that compatible players know how to interpret. Not all apps support them, so check your player’s documentation before relying on catch-up features.
Where to get IPTV files
This is where most guides give vague or outdated advice. Here is a clear breakdown.
Free-to-Air public sources
Free-to-air public sources exist, but their limitations matter more than their existence. They cover only legally free-to-air channels, so you will not find premium sports, pay TV, or movie networks in them. Stream reliability is also inconsistent; links break frequently and updates can lag behind, meaning a playlist that works today may have dead URLs within days. If free-to-air channels are all you need and you do not mind occasional maintenance, they are a starting point. If you want premium channels that stay working, a licensed provider is the only realistic option.
Licensed IPTV providers
For premium channels, you need a subscription from a licensed provider. The provider hosts their own M3U file and gives you a URL, sometimes with a token appended, that only works while your subscription is active.
Vivimate operates this way. You get a single playlist URL after subscribing, load it into your app once, and the channel list updates on their end without you doing anything. That is the practical advantage over managing public files yourself.
When evaluating any licensed provider, check whether they offer a trial period, how they handle buffering during peak hours, and whether their EPG data is included or costs extra.
Files to avoid
Any site offering a static .m3u download claiming thousands of premium channels for free is almost certainly distributing unauthorized streams. Beyond the legal risk, these files go stale fast. Stream URLs for paid channels change frequently as broadcasters rotate them to block unauthorized access. A file downloaded today may be largely broken within days.
How to load IPTV files into your player
The process differs slightly between apps, but the logic is the same everywhere.
VLC
Go to Media, then Open Network Stream, and paste the M3U URL. VLC will read the file and populate a playlist you can browse. It does not display logos or EPG data, but it works on almost every device.
TiviMate
Open the app, go to Add Playlist, and choose M3U Playlist. Paste the URL. TiviMate has a separate field for EPG URL in the playlist settings. It handles logos, guide data, and catch-up in a full TV-style interface.
IPTV Smarters
Use the Xtream Codes option if your provider supplies login credentials, or use the M3U URL option if they give you a direct file link. Both methods end up loading the same channel data.
Kodi
Install the PVR IPTV Simple Client add-on from the official Kodi repository. Point it to your M3U URL and optionally your EPG URL in the add-on settings. Kodi then exposes channels through its Live TV section.
Troubleshooting common IPTV file problems
Channels not loading
Start by testing a single stream URL from your M3U file in VLC’s Open Network Stream. If it plays there but not in your main app, the problem is the app’s configuration. If it fails in VLC too, the stream URL is dead or geo-blocked.
Playlist loads but no guide data
The EPG URL is either missing from your settings or the tvg-id values in your M3U do not match the channel IDs in the EPG file. Check that both files come from the same provider, or that you are using a compatible public EPG source.
App shows zero channels after loading
Some apps time out if the M3U file is very large and the server responds slowly. Try downloading the file locally first, then loading it from local storage. If that works, the issue is server response time, not the file itself.
If channels are missing from a specific group, check whether the app has a group filter active. TiviMate and IPTV Smarters both allow you to hide entire group-title categories, and it is easy to hide one accidentally.
Frequently asked questions
What is an IPTV file? An IPTV file is a plain-text document, usually with a .m3u or .m3u8 extension, that lists the URLs of live TV streams. Your player reads the file and uses those URLs to fetch video directly from the broadcaster’s servers.
Are IPTV files legal? The file format itself is legal. Whether a specific playlist is legal depends entirely on what streams it points to. Files that link to licensed or free-to-air broadcasts are fine; files that link to paid channels without authorization are not.
Why do IPTV files stop working? Stream URLs expire, broadcasters change their CDN endpoints, and free public lists often go weeks without updates. Licensed providers refresh their URLs automatically, so you rarely notice the change.
Can I use one IPTV file across different apps? Yes. M3U is a universal format. The same file works in VLC, Kodi, TiviMate, IPTV Smarters, and most other players without any conversion.
What is an EPG file and do I need one? EPG stands for Electronic Program Guide. It is an XML file that maps show schedules to each channel in your playlist. You do not need it to watch channels, but without it your player shows no guide data, just a blank grid.