IPTV M3U playlists explained

An M3U playlist is a plain-text file that lists video streams. In IPTV, it's one of the two common ways a provider gives you access to its channels (the other is an Xtream Codes login). You paste the playlist's web address into an IPTV player app, and the app turns the list into a channel menu.

What's inside an M3U file

Open an M3U playlist in a text editor and you'll see a header line followed by pairs of lines, one pair per channel:

#EXTM3U
#EXTINF:-1 tvg-id="channel.one" tvg-logo="https://…/logo.png" group-title="Entertainment",Channel One
https://stream.example.com/live/username/password/1234.ts

• #EXTM3U marks the file as an extended M3U playlist.
• #EXTINF describes the next stream: its display name and optional attributes. The -1 straight after it means the stream has no fixed length, which is normal for a live channel; films sometimes show their length in seconds instead.
• tvg-id links the channel to its listings in the TV guide (EPG).
• tvg-logo is the channel logo shown in your app.
• group-title is the category the channel appears under.
• The final line is the stream address itself.

Most providers give you a single web link to the playlist rather than a file, so the list can be updated without you doing anything. A downloaded file, by contrast, is a snapshot: if channels move or are added, it goes out of date and needs downloading again.

Reading an M3U link

Playlist links from services that also offer Xtream logins usually follow the same pattern, and two parts of it are worth knowing about:

http://server.example.com:8080/get.php?username=…&password=…&type=m3u_plus&output=ts

• type=m3u_plus asks for the full version of the list, with channel names, logos, groups and guide IDs. Plain type=m3u leaves those out, so channels appear unsorted and without logos.
• output=ts or output=m3u8 chooses the stream format: MPEG-TS or HLS. If streams won't start in a particular app, the other format sometimes works better. Ask us before changing it.

Loading an M3U link into an IPTV app

1. 1

   Open your player app

   For example IPTV Smarters Pro, TiviMate or GSE Smart IPTV.
2. 2

   Choose to add a playlist

   Look for an option such as “Add playlist”, “Load your playlist or file/URL” or “M3U URL”.
3. 3

   Paste the full link

   Copy it exactly, including http:// or https:// and everything after it.
4. 4

   Add the EPG link if the app asks

   If your provider gave you a separate guide (XMLTV) link, add it so the TV guide fills in.

Typing long links with a TV remote is fiddly. Many apps let you add playlists from a phone or computer instead, and some, like Smart IPTV, require you to upload the link through the developer's website.

How to play M3U files in VLC

VLC media player, which is free on Windows, Mac, Linux, Android and iOS, can play M3U playlists. It's handy for testing a link, though it has no TV guide.

1. Open VLC and choose Media > Open Network Stream (on Mac: File > Open Network).
2. Paste the M3U link and select Play.
3. Open the playlist view (Ctrl+L on Windows) to see and switch between channels.

If you've downloaded an .m3u file instead, use Media > Open File. Large playlists can take a minute to open in VLC, because it reads every entry first. For a full TV-style experience on a computer, see our guides to IPTV players for Windows and IPTV players for Mac.

A note on “free M3U playlists”

Lists of free playlists circulate online. Some point to legitimately free channels, but many link to streams shared without the rights holder's permission, and links from unknown sources can be unreliable or unsafe. Our guide is IPTV legal in the UK? explains why that matters.