Quick answer: an M3U playlist is a plain text file that lists media streams one after another. Players such as VLC, Kodi, IPTV Smarters Pro and TiviMate read the file and build a channel list from it. You can load it from a link (URL) or from a file on your device.
What is an M3U playlist?
M3U began as a simple format for audio playlists. Today it is also the most common way to share a list of TV channels and videos. The file does not contain the video itself. It only contains the names and the addresses of the streams, and your player fetches each stream when you press play.
M3U vs M3U8
The two names are used almost interchangeably. M3U8 is the same format saved with UTF-8 text encoding, which handles accented and non-Latin characters correctly. The .m3u8 extension is also used for HLS streams, which are segmented video streams. In IPTV, both a playlist file and a stream address can end in .m3u8, so look at what it contains rather than at the extension alone.
What is inside an M3U file
Open an M3U file in a text editor and you will see something like this. The example below uses a made-up address:
#EXTM3U
#EXTINF:-1 tvg-id="channel1" tvg-name="Channel One" tvg-logo="logo.png" group-title="News",Channel One
http://example.com/stream/channel1.m3u8
#EXTM3Umarks the file as an extended playlist#EXTINFdescribes one entry: its name, logo, group and ID for the TV guide- The line below it is the stream address
The tvg-id value matters because it is how a TV guide (EPG) is matched to each channel.
The two ways to use an M3U
- M3U URL: a web address that returns the playlist. Many IPTV providers give you a link of this type. It often contains your username and password inside the address
- M3U file: a file saved on your device that you open or import in a player
Because an M3U URL from a provider usually contains your login, keep it private. Anyone with the link may be able to use your account.
How to open an M3U playlist
In VLC
- Open VLC
- Choose Media > Open Network Stream for a link, or Media > Open File for a saved file
- Paste the link or select the file and press Play
- Open View > Playlist to see the channels
In Kodi
- Open Add-ons and install PVR IPTV Simple Client
- Open its settings and set the playlist location to your link or file
- Add the EPG (XMLTV) link if you have one
- Restart Kodi and open TV
In IPTV Smarters Pro or TiviMate
- Choose Add playlist
- Select M3U playlist
- Paste the link or choose the file
- Add an EPG link if asked, then confirm
Need help with a specific app? See our TiviMate setup guide and the list of the best IPTV player apps.
M3U and the TV guide (EPG)
An M3U file does not include programme information. The guide comes from a separate XMLTV address. To make it work, add that address in your player and make sure the tvg-id of each channel matches the guide. If many channels have no guide, the IDs do not match.
Editing an M3U playlist
- Open it in a plain text editor, not a word processor
- Keep each
#EXTINFline directly above its stream address - Save with UTF-8 encoding
- Make a copy first, in case you break the format
Editing is useful for removing groups you do not need or reordering channels. If your provider updates the playlist, a manual edit will be lost when you reload the link.
Common M3U problems
- Playlist will not load: check the link for extra spaces, a missing part or an expired account
- App crashes or is slow: a very large playlist can overload a weak device. Try a lighter player or Xtream Codes. See M3U vs Xtream Codes
- No TV guide: add the XMLTV link and check the
tvg-idvalues - Strange characters: save the file as UTF-8
- Streams stutter: see our IPTV buffering guide
Is using an M3U playlist legal?
The M3U format itself is perfectly legal. It is just a text format. What matters is the content it points to: you need the right to watch the streams in your playlist. Check the source before you rely on it. Read more in what is IPTV.
Frequently asked questions
What does M3U stand for?
It originally stood for MP3 URL, because it was created for audio playlists. It is now used for video as well.
How do I create an M3U file?
Create a text file, start it with #EXTM3U, add an #EXTINF line and a stream address for each entry, then save it as .m3u or .m3u8 in UTF-8.
Can I use an M3U link on my phone?
Yes, in any player that supports it, such as IPTV Smarters Pro or VLC. See IPTV for Android or IPTV for iPhone.
Is M3U or Xtream Codes better?
Xtream Codes usually loads faster on large lists. M3U is more widely supported and easier to edit.
Why is my M3U link not working?
The most common causes are a copy error, an expired account, a blocked connection or a connection limit. Re-copy the link first.
Next steps
Pick a player, load your playlist and check the TV guide. If you still need a provider, compare the available subscription plans and ask support which login types are included.