What is an M3U playlist?

What is inside the file, M3U versus M3U8, and how a playlist link differs from an Xtream Codes account.

SlothMate provides no channels, movies, series, playlists, guide data, or media subscriptions. Bring your own legal sources or personal files. SlothMate is not affiliated with any IPTV or media provider.

About 4 minutes

A plain text list of streams

An M3U playlist is a plain text file that lists media addresses, one entry after another. The format started with music players; IPTV uses an extended form in which each entry also carries a channel name, a group, and details that help a player match a programme guide. You can open one in any text editor and read it.

Here is a short, entirely fictional example. The addresses use the reserved example domain, so they lead nowhere.

#EXTM3U
#EXTINF:-1 tvg-id="news.one" tvg-name="News One" tvg-logo="https://provider.example/logos/news-one.png" group-title="News",News One
https://provider.example/live/news-one.m3u8
#EXTINF:-1 tvg-id="nature.two" group-title="Documentaries",Nature Two
https://provider.example/live/nature-two.m3u8

What each line means

#EXTM3U
The header on the first line: this is an extended M3U playlist.
#EXTINF:-1
Starts the description of one entry. The number is the length in seconds; -1 means a live stream with no fixed length.
group-title
The group the channel belongs to. In SlothMate, groups become the categories in Live TV, and an entry without a group lands in Ungrouped.
tvg-id and tvg-name
Guide identifiers. A player uses them to match the channel to its listings in an XMLTV programme guide. SlothMate tries the tvg-id first, then the tvg-name, then the channel name.
tvg-logo
The address of the channel's logo image.
The text after the comma
The channel name shown in the list.
The next line
The stream address itself.

M3U or M3U8?

An .m3u8 file is the same kind of list saved as UTF-8 text, which keeps accented and non-Latin channel names intact. The .m3u8 extension is also used by HTTP Live Streaming for the stream manifests that many channel addresses point to, which is why stream addresses inside a playlist often end in .m3u8 too. SlothMate opens playlist files with either extension.

An M3U link or an Xtream Codes account?

An M3U link is simply the web address of a playlist file. It often contains a personal token, so treat the whole link like a password. An Xtream Codes account is a sign-in to a provider's server with a server address, username, and password. In SlothMate, an M3U playlist provides Live TV only, with a guide you paste in yourself, while an Xtream Codes account can also bring Movies and Series, the account status, the connection limit MultiView uses, and a full guide in one click. The Xtream Codes player for Mac page compares the two.

Where a playlist comes from

From the provider of a TV service you use, or from a broadcaster that publishes its own. A playlist is only as legitimate as the source behind it; Is IPTV legal? explains why. SlothMate itself includes no playlists.

How to open an M3U playlist on a Mac

In SlothMate, choose M3U File on the Start screen to pick an .m3u or .m3u8 file in the native file picker, or M3U Link to paste a playlist address. The step-by-step guides are Add an M3U playlist file and Add an M3U playlist link, and the M3U player for Mac page sums up what you get.