The File That Tells Your IPTV App What to Play
An M3U playlist is a simple text file that contains a list of channel URLs. When your IPTV app loads an M3U file, it reads each URL and creates your channel list. Think of it as a table of contents for your IPTV service — it tells the app where to find each channel's stream.
M3U Playlist Structure
A basic M3U file looks like this:
#EXTM3U
#EXTINF:-1 tvg-name="BBC One" tvg-logo="logo.png" group-title="UK",BBC One HD
http://server.com/live/username/password/12345
#EXTINF:-1 tvg-name="CNN" tvg-logo="logo.png" group-title="News",CNN HD
http://server.com/live/username/password/12346
| Component | Purpose |
|---|---|
#EXTM3U | Header that identifies the file as an M3U playlist |
#EXTINF | Channel information line (name, logo, group) |
tvg-name | Channel name displayed in your app |
tvg-logo | URL to the channel's logo image |
group-title | Category grouping (Sports, News, Entertainment) |
http://... | Direct URL to the video stream |
M3U vs Xtream Codes API
| Feature | M3U Playlist | Xtream Codes API |
|---|---|---|
| Setup complexity | Paste one URL | Enter username/password/server |
| Channel organization | Depends on provider | Always organized |
| EPG | Requires separate URL | Usually built-in |
| VOD access | Sometimes included | Always included |
| Auto-refresh | Manual refresh needed | Automatic |
| Recommended for | Advanced users | Everyone (easier) |
Our recommendation: Use Xtream Codes API when available. It is simpler, more reliable, and includes VOD and EPG automatically. M3U is a fallback option for apps or providers that do not support Xtream Codes.
How to Use an M3U Playlist
Getting Your M3U URL
Your IPTV provider sends the M3U playlist URL via email after signup. It typically looks like:
http://provider-server.com/get.php?username=YOUR_USER&password=YOUR_PASS&type=m3u_plus
Adding to Your IPTV App
TiviMate: Settings → Playlists → Add Playlist → M3U Playlist → Paste URL
VLC: Media → Open Network Stream → Paste URL → Play
Kodi: PVR IPTV Simple Client → Settings → Playlist URL → Enter URL
📋 Both M3U and Xtream Codes provided. Start a free NexusXtream trial — choose whichever connection method suits your app.
Frequently Asked Questions
What is the difference between M3U and M3U8?
M3U is a standard playlist format. M3U8 is the UTF-8 encoded version that supports international characters. Most IPTV apps handle both identically.
Can I edit my M3U playlist?
Technically yes — it is a text file. You can remove unwanted channels, reorder entries, or change group names. However, most apps let you organize channels within the app itself, making manual editing unnecessary.
Why do some M3U links stop working?
Your provider may change server addresses, or your URL may have expired. Request a fresh URL from your provider if channels stop loading.
Is M3U or Xtream Codes better?
Xtream Codes is better for most users — it auto-loads EPG, VOD, and organized channel lists. M3U is useful for apps that do not support Xtream Codes or for advanced users who want manual control.
Can I use one M3U playlist on multiple devices?
Yes, as long as your subscription allows multiple connections. The same URL works on any device and any IPTV app.
The Simpler Way
For most users, Xtream Codes API is the recommended connection method — it handles everything automatically. M3U is there when you need it, but Xtream Codes eliminates the need to manage playlist files manually.
Both options included. Start your free NexusXtream trial.