Skip to content
GuardianTV Live logoGuardianTV Live

Explainers

M3U vs Xtream Codes explained

Both deliver the same channels. One is a flat text file; the other is a structured API with films, series and a proper guide.

Published · Updated · 3 min read

Both are ways of getting the same channels from the same provider onto your screen. The difference is how much structure comes with them.

An M3U line looks like this:

http://provider.com:8080/get.php?username=USER&password=PASS&type=m3u_plus

Request it and you get plain text back — one entry per channel:

#EXTINF:-1 tvg-id="SkySportsMainEvent.uk" tvg-logo="https://.../logo.png" group-title="UK SPORTS",Sky Sports Main Event
http://provider.com:8080/live/USER/PASS/12345.m3u8

A description line and a stream URL. That's the whole format.

Strengths: universal. Every player ever written opens an M3U — browsers, VLC, Kodi, smart TVs, everything. Nothing to configure beyond one URL.

Weaknesses: flat. No separation between live TV, films and series; no artwork beyond a logo URL; EPG only if you supply a separate XMLTV file. A 20,000-channel M3U is a very long list.

Xtream Codes: a structured API

Xtream Codes takes three fields instead of one:

Server:   http://provider.com:8080
Username: your_username
Password: your_password

The app then queries the API and pulls back organised data — live channels by category, a films library with posters and descriptions, series with seasons and episodes, the EPG, and often catch-up.

Strengths: feels like a real streaming service. Separated sections, artwork, synopses, a proper guide grid, catch-up TV, and resume-where-you-left-off. Only the categories you open are loaded, so large accounts stay responsive.

Weaknesses: requires an app that speaks the protocol. Browsers and VLC don't.

Side by side

M3U Xtream Codes
Setup One URL Server + username + password
Live TV Yes Yes
Films / series library Mixed into one list Separate sections with artwork
EPG Separate XMLTV file Built in
Catch-up TV No Usually
Works in a browser Yes No
Works in VLC Yes No
Large playlists Can be slow Loads on demand

Which apps support which

Both: IPTV Smarters Pro, TiviMate, OTT Navigator, Perfect Player, GSE Smart IPTV M3U only: browsers (including our web player), VLC, Kodi's PVR Simple Client, most smart TV browsers Xtream only: a handful of provider-branded apps

Which should you use?

Use Xtream Codes on your main TV device, if the app supports it. The interface is substantially better and you get the films library and catch-up.

Use M3U for compatibility — the browser, a laptop, VLC, an old smart TV, or anywhere Xtream isn't an option.

You don't have to choose. Nearly every provider issues both for the same account, so most people run Xtream Codes on the Firestick and keep the M3U line for the browser and laptop.

A security note

Both formats embed your username and password. An M3U URL contains them in plain text in the query string.

That means: don't post your M3U line in forums, Discord servers or support threads. Anyone who copies it is using your connection slots, which will get you locked out for exceeding your limit — and looks like your account being abused.

Our web player parses playlists entirely in your browser precisely for this reason. The URL is never uploaded to or stored on our servers. See the Privacy Policy.

Getting both

GuardianTV issues an M3U line and Xtream Codes credentials with every subscription, including the free 12-hour trial — which takes no card details, so you can test both formats on your own devices before deciding anything.

Frequently asked questions

What is the difference between M3U and Xtream Codes?

An M3U line is a single URL that returns a flat text playlist of channels. Xtream Codes is an API where you enter a server address, username and password separately, and the app retrieves live TV, films, series and the EPG as structured data. Xtream Codes gives a richer interface with categories, artwork and catch-up; M3U works in more players including browsers and VLC.

Which is better, M3U or Xtream Codes?

Xtream Codes is better when your app supports it, because you get separated Live/Movies/Series sections, artwork, a proper EPG and usually catch-up TV. M3U is better for compatibility — it works in browsers, VLC and every player ever made. Most providers issue both for the same account, so you can use whichever suits each device.
Free 12-Hour Trial · No card required

Want the other 45,000+ channels?

GuardianTV Live is free forever, but it only carries free-to-air streams. GuardianTV Premium adds every Sky Sports and TNT Sports feed, 115,000+ films and box sets, and 99.9% AntiFreeze uptime. Test the whole service free for 12 hours — no card details.

Instant WhatsApp activation Cancel anytime 24 hours a day, 7 days a week, 365 days a year support

Live channels
45,000+
Films & box sets
115,000+
Server uptime
99.9%
UK customers
10,000+

Keep reading