M3U playlists explained

M3U is one of the oldest playlist formats on the internet. It was created for music, listing songs in the order they should play, but because it can list any media address, it became the standard way to share IPTV channel lists. When we send you an M3U link, you’re receiving a single address that contains your whole channel list.

What an M3U playlist looks like inside

An M3U file is plain text. You never need to edit it, but knowing what’s inside helps when something doesn’t look right. A playlist starts with a header line, then has two lines for each channel:

#EXTM3U url-tvg="http://server.example:8080/xmltv.php?..."
#EXTINF:-1 tvg-id="example.news" tvg-name="Example News HD" tvg-logo="http://.../logo.png" group-title="News",Example News HD
http://server.example:8080/live/.../12345.ts

• #EXTM3U marks the file as an extended M3U playlist. The optional url-tvg tells players where to find the TV guide.
• #EXTINF describes one channel. tvg-id links it to the guide, tvg-logo is its logo, and group-title is the category it appears under.
• The next line is the stream address the player opens when you choose that channel.

That’s all a playlist is: a list of names, categories and addresses. The player does the rest.

M3U vs Xtream Codes

Both give you the same channels. The difference is how much the player gets automatically:

If your player supports it, Xtream Codes is usually the better experience. M3U is the universal fallback, and the only option for players such as VLC and Smart IPTV.

M3U or M3U8?

An .m3u8 file is the same format saved with UTF-8 encoding, so accented characters and non-English channel names display correctly. Players treat them identically. (You may also see M3U8 mentioned in streaming more generally, where the same file type describes the chunks of a single HLS video stream, but for channel lists it simply means “UTF-8 playlist”.)

How to use an M3U playlist

In a player app

Choose Add playlist → M3U URL (the wording varies), paste the full link and give it a name. Then add the TV guide link in the player’s EPG settings if it doesn’t appear by itself. Our device guides cover each step: Samsung, LG, Android TV box and more.

In VLC on Windows or Mac

1. Open Media → Open Network Stream (Windows) or File → Open Network (Mac).
2. Paste your M3U link and select Play.
3. Open the playlist view (View → Playlist) to see and switch channels.

VLC shows no guide and can be slow with very large playlists, but it’s a quick, trustworthy way to test a subscription. See IPTV player for Windows.

In Kodi

Install the official PVR IPTV Simple Client add-on, enter your M3U link under General and your guide link under EPG, then restart Kodi. Channels and the guide appear under TV.

Adding the TV guide (EPG)

The TV guide comes from a separate file in XMLTV format. With an M3U playlist, you add it in one of two ways:

• Automatically: if the playlist’s first line includes url-tvg, many players load the guide by themselves.
• Manually: paste the guide link we send into the player’s EPG settings.

Each channel’s tvg-id must match an entry in the guide. If some channels show no programme information, the channel may not provide guide data. Our TV guide (EPG) help covers fixing gaps and wrong times.

Common M3U problems

“Invalid playlist” or nothing loads

The link was probably cut short when copying. Paste it again in full. It’s usually long, and every character matters.

The playlist loads but channels won’t play

Some players need a different stream format. Tell us which player you’re using, and we’ll send the link in the format it prefers.

Channel list is huge and slow

Very large playlists can overwhelm older devices. Use a player that lets you hide groups, or switch to an Xtream Codes login, which most players handle more efficiently.

A note on free M3U playlists

Searching for M3U playlists turns up many free lists. Some are community projects that collect publicly available free channels, and those can be interesting to explore. Many others, shared on forums and video sites, point to unlicensed streams. Those lists stop working constantly, often lead to unsafe downloads, and in the UK watching unlicensed streams can itself be an offence (see is IPTV legal). Our guide to free IPTV playlists covers the risks and the legal alternatives in more detail.

A subscription with a real provider gives you a stable, supported playlist, a working TV guide and someone to ask when something goes wrong.