What is an M3U playlist?
Updated
An M3U playlist is a plain text file, or a link to one, that lists stream addresses with a name for each. IPTV providers use it to hand a player their channel list: the player reads every entry as a channel, with its group, logo and TV guide ID. M3U8 is the same format, saved as UTF-8 text.
The format is older than IPTV. It began as a way to list music files for a media player, and the name comes from MP3 URL. Because it is only text, anything can write it and almost any player can read it, which is why IPTV providers adopted it for channel lists. Here is what is inside one, how a player uses it, and where its limits are.
What is inside an M3U file
An M3U playlist from an IPTV provider looks like this, with thousands of entries instead of two:
#EXTM3U
#EXTINF:-1 tvg-id="news.example" tvg-name="Example News" tvg-logo="https://example.com/logos/news.png" group-title="News",Example News
https://stream.example.com/live/news.m3u8
#EXTINF:-1 tvg-id="sport1.example" tvg-name="Example Sport 1" tvg-logo="https://example.com/logos/sport1.png" group-title="Sport",Example Sport 1
https://stream.example.com/live/sport1.tsLine by line:
#EXTM3Uopens the file and tells the player this is an extended M3U playlist, with details for each entry.#EXTINFstarts an entry. The-1means the length is unknown, as it is for a live channel, and the text after the last comma is the name the player shows.tvg-idis the channel’s ID in the TV guide. It is how a player links the channel to its programmes.tvg-nameis the name the guide uses, andtvg-logois the address of the channel’s logo.group-titleis the category, such as News or Sport. Players use it to sort channels into groups.- The line after each entry is the stream address itself: where the player goes to fetch the picture.
The tvg- tags are a convention from IPTV software rather than part of the original format, and providers fill them in with varying care. A playlist with missing IDs still plays; its guide just has to be matched by channel name instead.
M3U or M3U8?
An .m3u8 file is an M3U file saved as UTF-8, so channel names in any language come through intact. For a channel list, the two behave the same, and ZiroTV reads both.
The same extension also has a second job. Streaming video (HLS) uses an .m3u8 file for a single stream: a short list of video pieces the player fetches one after another. So a link ending in .m3u8 is not always a channel list. If a player shows one channel, or none, for a link you expected to hold hundreds, it is probably a single stream.
Where an M3U link comes from
From your IPTV provider, usually in the welcome email or in your account on its website. Many providers generate the link from your login, in a form like this:
http://server.example.com:8080/get.php?username=YOUR_NAME&password=YOUR_PASSWORD&type=m3u_plus&output=tsThat shape tells you two things. First, your username and password are part of the link, so anyone who has the link can use your subscription: treat it like a password. Second, the provider most likely offers an Xtream Codes login too, which gives a player more than the M3U link does. Xtream Codes vs M3U explains the difference.
ZiroTV does not supply playlists and cannot help you find one. Use a provider that has the rights to the channels it offers.
How a player reads an M3U playlist
- It downloads the file from the link.
- It reads each entry: name, stream address, group, logo and guide ID.
- It builds the channel list, sorted into groups.
- If you added an EPG link, it downloads the guide and matches programmes to channels by
tvg-id, then by name. - It fetches the list again from time to time, so channels your provider adds or removes show up.
In ZiroTV, the channels appear as soon as the list is read, and the TV guide fills in shortly after. How often the list is fetched again is up to you: Re-sync channels & guide in the TV app’s settings (Auto refresh on a phone) offers Every launch, Daily or Weekly, and Re-sync now fetches it straight away.
What an M3U playlist cannot do
- It carries no TV guide. The schedule lives in a separate EPG file, so an M3U playlist needs an EPG link next to it. How the IPTV guide works.
- It is one flat list. Films and series arrive, if at all, as more entries in the same list, without posters, seasons or descriptions. In ZiroTV, films and series need an Xtream Codes login.
- It does not bring catch-up in ZiroTV. ZiroTV plays catch-up and live rewind from an Xtream Codes login. Catch-up and live rewind, explained.
- It arrives in one piece. A list with tens of thousands of entries has to be downloaded and read in full before any channel appears, which takes longer than an Xtream Codes login that sends the list in parts.
How to add an M3U playlist to ZiroTV
- Open ZiroTV. On the first start, choose Add your first playlist; later, open Settings and choose Add playlist.
- Choose M3U Playlist.
- Give it a Name, such as Home, and paste your link into Playlist URL, replacing any text already in the field.
- If your provider gave you an EPG link, add it under EPG / TV guide URL.
- Select Add & Sync.
Typing a long link with a remote is slow. On a TV, choose Add from your phone instead, scan the code, and paste the link on your phone. ZiroTV takes a link, not a file stored on the device.
If ZiroTV says That playlist has no channels, the link is wrong, has expired, or points at a single stream. Wrong username or password for this provider means the provider refused the login inside the link. Check both with your provider.
Questions.
How do I play an M3U file?
Open it in a player that reads M3U. For TV channels from a provider, add the M3U link to an IPTV player, which shows the channels in groups with a TV guide. For a music or video playlist on your computer, a media player such as VLC opens the file directly.
What is the best M3U player?
The one that suits the screen you watch on. On a TV, look for a channel list made for the remote, quick zapping and a TV guide that reads your EPG link. On a phone, look for a proper touch layout. ZiroTV does both from one app. Whichever you choose, try it with your own playlist before you pay for it.
Can VLC play M3U?
Yes. VLC opens M3U and M3U8 files and links, and plays the streams in them. It has no TV guide and no channel list made for a remote, which is why most people watch a provider’s playlist in an IPTV player instead.
Bring your M3U link.
Add it to ZiroTV on your TV or phone, and try every feature free for 7 days.
Already have an account? Sign in at app.zirotv.com