When you subscribe to IPTV you usually receive two kinds of login details: an M3U playlist link and an Xtream Codes login. Both give your player app access to the same channels, but they work differently. This guide explains each in plain English, shows how to add them to the most popular apps, and helps you fix the errors people run into most.
Key takeaways
- An M3U playlist is a link to a text file listing every channel and its stream address.
- Xtream Codes is a login (server URL, username, password) that connects the app to your account.
- Xtream Codes is usually faster, splits Live/Movies/Series and loads the EPG automatically.
- M3U works in almost every player, including VLC.
- Never share your login publicly — it is tied to your subscription.
What is an M3U playlist?
An M3U file is a simple text file. Each entry contains a channel name, an optional logo and group, and the web address of the stream. IPTV providers usually give you an M3U URL — a link that generates your personal playlist when a player opens it.
A typical M3U URL looks like this (example only):
http://server.example:8080/get.php?username=YOURNAME&password=YOURPASS&type=m3u_plus&output=ts
The m3u_plus part includes channel logos and groups; output=ts or output=m3u8 sets the stream format.
What are Xtream Codes?
Xtream Codes (often shown as “Xtream Codes API” or “Login with Xtream”) is a login method rather than a file. You enter three details:
- Server URL — e.g.
http://server.example:8080 - Username
- Password
The app then talks to your provider's server directly and downloads Live TV, Movies, Series and the TV guide as separate sections.
/get.php, followed by your username and password.M3U vs Xtream Codes: which should you use?
| M3U playlist | Xtream Codes | |
|---|---|---|
| Format | Link to a playlist file | Server URL + username + password |
| Loading speed | Slower for large lists | Faster |
| TV guide (EPG) | Often added separately | Usually automatic |
| Movies & series | Mixed into one long list | Separate, organised sections |
| Compatibility | Almost every player, incl. VLC | Most dedicated IPTV apps |
| Best for | Simple players, MAC-based TV apps | TiviMate, Smarters, IBO Player |
Our recommendation: use Xtream Codes whenever your app supports it, and keep the M3U link as a backup.
How to add M3U or Xtream Codes to popular apps
TiviMate
Add playlist › choose Xtream Codes › enter server, username and password › Next. Or choose M3U playlist and paste the URL. Full TiviMate guide.
IPTV Smarters Pro
Choose Login with Xtream Codes API, enter any name plus your details, then Add User. Full Smarters guide.
IBO Player
Note the MAC address and device key on the TV, then add your M3U or Xtream details on the app's website. Full IBO Player guide.
VLC (PC, Mac, phone)
Media › Open Network Stream › paste the M3U URL › Play. Good for testing, though there is no TV guide.
How to add a TV guide (EPG)
An EPG (Electronic Programme Guide) shows what's on now and next. With Xtream Codes it usually loads automatically. With an M3U playlist, add your provider's EPG link (often ending in xmltv.php) in the app's Settings › EPG section, then update the guide. Allow a few minutes the first time.
TS vs M3U8 (HLS): which stream format?
Many providers let you choose the stream output in your M3U link or in the app settings:
| Format | How it works | Best for |
|---|---|---|
| MPEG-TS (.ts) | A continuous stream with very low delay | Live TV and sport on a stable connection |
| HLS (.m3u8) | Video split into small segments; adapts better to network changes | Wi-Fi, mobile data and Apple devices |
If a channel freezes or won't start, switching between the two formats is one of the quickest fixes.
Using several devices and playlists
You can add the same login to your TV, Firestick, phone and tablet. Keep in mind:
- Connections limit: your plan allows a set number of streams at the same time. Watching on more devices at once will show a “max connections” error.
- One playlist per app: if you have two subscriptions, add them as separate playlists and give each a clear name.
- Refresh after changes: if your provider adds channels or changes servers, update the playlist in the app.
- Back up your settings: apps like TiviMate can back up favourites and settings so you can restore them on a new device.
Common M3U & Xtream errors and fixes
| Error | Likely cause | Fix |
|---|---|---|
| “Invalid credentials” / 401 | Typo in username or password | Copy-paste the details; check for extra spaces |
| “Playlist could not be loaded” | Wrong URL or http/https mismatch | Use the exact server URL including the port |
| Channels load but won't play | Stream format or decoder issue | Switch output between ts and m3u8; change decoder |
| “Max connections reached” | Too many devices streaming at once | Stop playback on other devices or upgrade your plan |
| Empty TV guide | EPG not added or not updated | Add the EPG URL and refresh the guide |
Still stuck? See IPTV Buffering: How to Fix It or contact our support team.
How to read an M3U entry
If you open an M3U file in a text editor, each channel looks roughly like this:
#EXTINF:-1 tvg-id="channel.id" tvg-logo="logo.png" group-title="News",Channel Namehttp://server.example:8080/username/password/12345
- #EXTINF starts a channel entry.
- tvg-id links the channel to the TV guide (EPG).
- tvg-logo is the channel logo shown in your app.
- group-title is the category (News, Sport, Movies…).
- The next line is the actual stream address.
You never need to edit this by hand — your player reads it automatically — but it helps to understand why a channel shows in the wrong group or without a guide.
Keep your login safe
- Don't post your M3U link or Xtream login online or in public groups.
- Only enter it in apps from official app stores.
- If you think it has been shared, ask your provider to reset your password.
Related IPTV guides
Frequently asked questions
What is an M3U playlist?
A link to a text file that lists every channel and the address of its stream. IPTV player apps read it to show your channel list.
What is the difference between M3U and Xtream Codes?
M3U is a playlist link; Xtream Codes is a login (server, username, password). Xtream Codes usually loads faster and organises Live TV, Movies and Series with an automatic TV guide.
Can I convert an M3U link into Xtream Codes?
Usually yes. The server is the part before /get.php, and the username and password are inside the link.
Why won't my M3U playlist load?
Check the URL was copied fully, includes the port number and uses the right http/https. Also confirm your subscription is active.
Can I use the same M3U link on multiple devices?
Yes, you can add it to several devices, but how many can stream at the same time depends on your plan.
Do I need both M3U and Xtream Codes?
No. One is enough. Use Xtream Codes where the app supports it and keep the M3U link as a backup.
Why are some channels missing from the TV guide?
The channel's tvg-id may not match the EPG source. Refresh the EPG or ask your provider to check the mapping.
Ready to start watching?
Thousands of live channels and on-demand titles on anti-freeze servers. Plans start from $14.99/month with a 7-day money-back guarantee.
Get Started with Best IPTV →