M3U vs Xtream Codes vs MAG Explained
The three IPTV login formats explained in plain English: what you receive, how each handles the TV guide and on-demand library, and which to pick.
When you sign up for IPTV, one of the first questions you’ll be asked is which login you need: an M3U playlist, an Xtream Codes login or a MAG portal. All three give you access to the same channels, but they work differently, suit different devices and handle extras like the TV guide and on-demand library in different ways.
This guide explains each format in plain English, compares them side by side and helps you choose the right one for your setup.
The short version
| M3U playlist | Xtream Codes | MAG portal | |
|---|---|---|---|
| What you receive | One long playlist link (plus a TV guide link) | Server address, username, password | Portal address, linked to your box’s MAC address |
| Works with | Almost every IPTV player | Most modern IPTV players | MAG and similar set-top boxes |
| TV guide (EPG) | Added separately | Loads automatically | Built in |
| Movies and series | Often mixed into the channel list | Neatly separated into libraries | Separate menus |
| Catch-up | Depends on player | Usually supported | Usually supported |
| Ease of setup | Easy (copy and paste) | Easy (three fields) | Easy (once the MAC is linked) |
| Best for | Basic players, maximum compatibility | Most people on TVs, sticks, boxes and phones | A simple TV-style experience |
What is an M3U playlist?
M3U is one of the oldest and most widely supported playlist formats. An M3U file is simply a text file that lists streams: for each channel there’s a line describing it (its name, logo and group) and a line with the stream’s web address. Your IPTV player reads the list and shows it as a channel guide.
A tiny, simplified example looks like this:
#EXTM3U
#EXTINF:-1 tvg-id="news.example" group-title="News",News Channel
http://stream.example/live/news
#EXTINF:-1 tvg-id="sport1.example" group-title="Sport",Sport 1
http://stream.example/live/sport1In practice you won’t see the file. Your provider sends a playlist link that generates it, and you paste that link into your player.
The TV guide: an M3U playlist doesn’t contain programme information itself. Instead, you add a separate EPG link (usually in XMLTV format), and the player matches guide data to channels using an ID in the playlist.
Pros:
- Works with almost every IPTV player on every platform.
- Simple: one link to copy and paste.
- Easy to use as a backup if another login type isn’t supported.
Cons:
- The link is long, so typing it by hand is error-prone.
- The TV guide is a separate step.
- Large playlists can be slow to load on low-powered devices, and movies and series may be mixed in with live channels, depending on the player.
What is an Xtream Codes login?
An Xtream Codes login uses three details: a server address (often including a port number), a username and a password. The name comes from the server software that popularised this style of login; today it’s a widely supported standard in IPTV players, often labelled “Xtream Codes API”.
Instead of downloading one big list, the player talks to the server and requests what it needs: live categories, channels, the TV guide, the movie library, series with seasons and episodes, and catch-up information. The result is a tidier, faster experience, with live TV, movies and series in separate sections.
Pros:
- Short details that are easy to enter on a TV remote.
- TV guide, movies and series load automatically.
- Better organisation and usually faster loading than a large M3U playlist.
- Catch-up and account information (such as your expiry date) are typically supported.
Cons:
- A few basic players only support M3U.
- Getting any one of the three fields wrong (including the port number) stops the login working.
What is a MAG portal?
MAG boxes are dedicated IPTV set-top boxes. They don’t use playlists or usernames. Instead, each box has a unique MAC address, a hardware identifier printed on a sticker underneath it. You send that MAC address to your provider, who links it to your subscription, and then you enter a portal address in the box’s settings. When the box connects, the portal recognises it and loads your channels, TV guide and on-demand menus.
Pros:
- A familiar, cable-box-style interface with a simple remote.
- Nothing to type each time, and fewer settings to get wrong.
- Very stable, with fewer moving parts than an app.
Cons:
- Only works on MAG-type boxes (and some apps that emulate them).
- Your subscription is tied to that box’s MAC address, so moving to a new box means asking your provider to update it.
- No app store, so the box does one job only.
Other terms you might see
- M3U8: the same playlist idea, saved with UTF-8 text encoding. You’ll also see .m3u8 at the end of individual stream addresses that use HLS, a common way of delivering video in small chunks.
- HLS and TS: two common stream types. Some players let you choose between them; if one buffers on your device, try the other.
- XMLTV: the standard format for TV guide data. An “EPG link” is usually an XMLTV address.
- Port: the number after a colon at the end of a server address, such as :8080. It’s part of the address and must be entered exactly.
- Portal URL: the address a MAG box connects to. It usually ends in /c/ and is case-sensitive.
Common setup mistakes, by format
M3U: typing a long link by hand and missing a character, or forgetting to add the EPG link and then wondering why the guide is empty. Always copy and paste the link, and add the guide link straight afterwards.
Xtream Codes: leaving off http:// or the port number, adding a trailing space after the username, or mixing up capital letters in the password. If you get an “invalid login” message, re-enter each field slowly or paste them one at a time.
MAG: sending the wrong MAC address (some boxes have more than one address listed, for Wi-Fi and Ethernet) or entering the portal URL into the wrong field. Use the MAC address shown under the box’s system information menu, and enter the URL in Portal 1.
Which should you choose?
- Smart TV, streaming stick, Android TV box, phone or tablet: choose Xtream Codes. It’s the easiest to enter and gives you the most complete experience.
- A player that doesn’t support Xtream Codes: use the M3U link, and add the EPG link for the TV guide.
- A MAG box: use the MAG portal.
- Not sure? Tell your provider which device and app you’re using and they’ll tell you which format fits best.
For most households, Xtream Codes on an Android TV box or Smart TV app is the sweet spot of simplicity and features. If you’re helping an older relative who just wants TV to work, a MAG box with a portal is hard to beat.
Can you switch formats later?
Usually, yes. The formats are just different doors into the same service. If you change devices, or find that a different player suits you better, ask your provider for the alternative login and set it up on the new device. MAG users moving to a new box should send the new MAC address so it can be linked.
Keeping your login secure
- Keep your details private. Anyone with your M3U link or Xtream Codes login can use your connection, which can interrupt your own viewing and may breach your provider’s terms.
- Don’t post playlists online or paste them into forums when asking for help. Contact your provider’s support directly instead.
- Use trusted player apps from your device’s official app store wherever possible.
Set up your login
IPTV NZ supports all three formats, so there’s an option for every device. Our guide to setting up IPTV walks through entering an M3U link, an Xtream Codes login or a MAG portal step by step. When you order, just tell us your device and we’ll send the right login. See IPTV NZ plans and prices, or explore everything included on the IPTV NZ homepage.
