M3U vs Xtream Codes: what they are and which to use
When you sign up with an IPTV provider, the welcome email hands you one of two things. Either a long web address called an M3U URL, or three separate details (a server address, a username, and a password) called Xtream Codes. Both do the same basic job: they tell a player app like seefax where your channels live. But they work differently, and the difference matters more than most guides let on.
What an M3U URL is
M3U is a playlist format that's been around since the days of WinAmp. An M3U playlist is a text file listing channels; each entry has a channel name, maybe a logo, and the web address of the stream. Your provider hosts this file and gives you a link to it, usually something like:
http://provider-server.com:8080/get.php?username=XXXX&password=YYYY&type=m3u_plusNotice your username and password are baked into the link itself. Paste it into a player and the app downloads the file, reads the list, and shows you the channels.
The good: dead simple. One link, paste it, done. Every player on earth supports it, including VLC.
The less good: it's a static snapshot. When your provider adds channels or reorganises categories, your player only finds out when it re-downloads the whole file. For big line-ups that's a large file and a slow refresh. Some providers also rotate M3U links for security, so the link you saved stops working and you have to fetch a new one. And the programme guide usually isn't included; it comes as a separate EPG link you add yourself.
What Xtream Codes is
Xtream Codes (properly, the Xtream Codes API) is a login rather than a file. You get three pieces:
- Server URL, e.g.
http://provider-server.com:8080 - Username
- Password
Instead of downloading one big list, your player logs into the provider's server and asks for what it needs: live channel categories, films, series, the programme guide. Each fetched separately, kept current. The credentials normally stay the same for your whole subscription, so nothing expires under you.
The good: faster loading, automatic updates, the EPG arrives without extra setup, and on-demand content is organised into films and series rather than dumped into one enormous list.
The less good: three fields to type instead of one. And not every provider offers it, though most that use Xtream-style panels give you both.
Which should you use?
If your provider gives you both, use Xtream Codes. It's more stable, the guide comes along automatically, and On Demand is properly structured. M3U is the right choice when it's all you've got, or when you're loading a public free-to-air playlist, which is usually published as M3U.
Here's the useful bit almost nobody tells you: they're usually the same account underneath. Most provider panels generate the M3U link from your Xtream credentials. Look at the example link above; the username and password are sitting right there in the URL. If your provider only sent an M3U link, you can often pull the server, username, and password out of it and log in as Xtream instead.
The mistake that catches everyone
The single most common setup failure is pasting a full M3U URL into an Xtream Codes login form. The Xtream server field wants just the base address. Domain and port, nothing after it.
- Right:
http://provider-server.com:8080 - Wrong:
http://provider-server.com:8080/get.php?username=...
Paste the long link into the server field and the login fails, and the error message rarely tells you why.
seefax sidesteps most of this. Paste whatever your provider sent (the full M3U link, the three Xtream details, even the whole welcome email) and the app works out what it's looking at. Still worth knowing what the two formats are, because when something goes wrong the fix depends on which one you're using.
Quick answers
Are Xtream Codes illegal?
No. Xtream Codes is a delivery format, like M3U or a PDF. Legality depends on whether your provider has licensed its content. We've covered that in full in our UK legality guide.
My M3U link stopped working. Why?
Three usual suspects: your subscription expired, the provider changed your password (which breaks the old link, since the password is inside it), or the provider changed its server setup. Ask for a fresh link. Or switch to their Xtream login, which survives most of these changes.
Can I use both at once?
Yes. They're two doors into the same account. Just watch your provider's connection limit; most subscriptions allow one stream at a time unless you've paid for more.
Where does the TV guide fit in?
With Xtream Codes, guide data comes from the same login. With M3U, you usually add a separate EPG URL. The whole EPG business is explained in its own post.
