IPTV Players
M3U vs Xtream Codes API Explained
The two ways an IPTV subscription connects to a player — what M3U playlists and the Xtream Codes API actually are, how they differ, and which to use when.
Updated 27 August 2026 · Reviewed by Nexlivo Support Team · 2 min read
Every IPTV welcome message contains login details that work in two formats, and every player app asks you to pick one: M3U or Xtream Codes API. They connect to the same service and show the same channels — but they work differently, and knowing which is which saves real confusion.
M3U: a playlist file
M3U is the older, simpler format: a text file listing every channel with its name and stream address. Your M3U link is a URL that generates this file for your account.
- Any player that can open a playlist can use it — including plain VLC with zero setup (see Windows or Mac).
- The playlist is a snapshot: channel changes on the service side only appear after the player re-downloads it.
- Film and series libraries arrive as one flat list, and the EPG usually needs a separate guide URL configured alongside.
Xtream Codes API: a live connection
The Xtream Codes API is a protocol: instead of one big file, the app logs in with username + password + server URL and asks the server for what it needs, when it needs it.
- Live, films and series arrive properly organised into their own sections with categories.
- The EPG comes bundled — no second URL to configure.
- Listings stay closer to current because the app queries the server rather than re-reading an old snapshot.
- It's what most modern apps (IPTV Smarters, TiviMate, IBO Player Pro) are designed around — it's the option our tutorials use.
Side by side
| M3U | Xtream Codes API | |
|---|---|---|
| You enter | One long URL | Username, password, server URL |
| Works in | Almost anything, incl. VLC | Modern IPTV players |
| Content organisation | One flat list | Live / films / series, categorised |
| EPG | Separate URL, extra setup | Included automatically |
| Freshness | Snapshot until re-downloaded | Queried live from the server |
| Best for | Quick tests, basic players | Day-to-day viewing |
Which should you use?
Use Xtream Codes API wherever the app offers it — better organisation, bundled EPG, less maintenance. Keep the M3U link as your diagnostic tool: if a stream plays via M3U in VLC but your main app misbehaves, the fault is in the app, not the service — an isolation trick that shortcuts a lot of troubleshooting.
Both formats use the same account. Adding your subscription to a second app with the other format doesn't create a second subscription — it's one plan, two doorways.
MAG boxes use neither — they connect through a portal URL registered to the box's MAC address. That flow has its own tutorial.