What is an M3U playlist? IPTV beginner's guide

If you have been looking into IPTV and keep encountering the terms "M3U playlist" and "Xtream Codes" without a clear explanation of what either means or which one you need, this guide is for you. Both are delivery formats for IPTV channels. They do the same job but in different ways, with meaningful differences in features and reliability.

WebflowMT provides both formats. Understanding the difference will help you choose the right one for your device and usage pattern.

What is an M3U playlist?

M3U stands for MP3 URL. The format was originally created in the late 1990s for creating playlists of audio files. The "M3U" name comes from the MPEG Audio Layer 3 (MP3) files it was designed to reference. The extended version, M3U8, uses UTF-8 encoding for better international character support.

An M3U file is a plain text file. You can open one in Notepad or any text editor and read it directly. Each channel entry in an IPTV M3U file looks something like this:

#EXTM3U
#EXTINF:-1 tvg-id="bbc1.uk" tvg-name="BBC One" group-title="UK",BBC One
http://streams.example.com:8080/live/user123/pass456/12345.ts

The first line declares this as an extended M3U file. The second line provides metadata about the channel: an ID, a display name, a group (used for organizing channels by country or type), and the channel name as it appears in the app. The third line is the actual stream URL your IPTV app will connect to.

When you load an M3U URL into an IPTV app, the app downloads this text file, parses all the entries, and presents you with a browsable channel list. The app then connects directly to each stream URL when you select a channel.

What is Xtream Codes?

Xtream Codes is the name of a popular IPTV server management panel (originally developed as commercial software, later abandoned by its original creators). The term "Xtream Codes" is now used generically to refer to the API format it popularized, regardless of which software the IPTV provider actually uses on their backend.

Instead of a static file, Xtream Codes uses a login-based API. When you set up an IPTV app with Xtream Codes, you enter three pieces of information: a server URL, a username, and a password. The app then queries the server's API, which returns a dynamically generated channel list, an EPG (electronic program guide with schedule data), a VOD catalogue, and catch-up TV availability.

Every time you open the app, it fetches the current channel list from the server. If the provider updates a stream URL, adds a channel, or removes one, the change is reflected automatically the next time you refresh. There is no stale file to deal with.

M3U vs Xtream Codes: key differences

For most regular users, Xtream Codes is the better choice. Here is why:

Dynamic updates. With M3U, if the provider changes a stream URL, your playlist breaks until you get a new URL. With Xtream Codes, the server automatically serves the current URLs. You never need to manually refresh anything.

EPG support. Xtream Codes delivers electronic program guide data automatically. This means you can see what is on now and coming up for each channel, browse future schedules, and set reminders, all from within your IPTV app. M3U can reference an external EPG URL, but it requires manual configuration and often has sync issues.

VOD integration. When a provider offers video on demand, Xtream Codes delivers the VOD catalogue through the same credentials. M3U can include VOD entries, but the integration is less seamless.

Catch-up TV. The ability to watch programs from the past 24 to 72 hours is an Xtream Codes feature. Most IPTV apps implement catch-up through Xtream Codes APIs. M3U does not natively support catch-up.

Despite Xtream Codes being better for most users, M3U has its place:

Compatibility. M3U is supported by every media player that can handle streaming video. VLC, MPC-HC, Kodi, QuickTime, and dozens of others all handle M3U natively without any IPTV-specific setup. Xtream Codes only works with apps that specifically support the Xtream Codes API.

Simplicity. For technical users who want to process a channel list programmatically, or load channels into non-standard environments, an M3U file is straightforward. It is just text with URLs.

Portability. You can copy an M3U URL into any application that accepts playlist URLs. Xtream Codes requires the app to specifically implement the API.

How to use M3U files with VLC

VLC is the universal media player and handles M3U playlists well. It is the easiest option for watching IPTV on a PC or Mac without installing dedicated IPTV software.

Open VLC. Go to the Media menu at the top. Click "Open Network Stream" (or press Ctrl+N on Windows, Command+N on Mac). In the Network URL field, paste your M3U URL from WebflowMT. Click Play.

VLC downloads the playlist file and begins playing the first channel. To see all channels, open the Playlist window by going to View, Playlist, or pressing Ctrl+L. Channels appear in the list organized by group (country or category). Double-click any channel to switch to it.

VLC is fine for casual use but does not have EPG, search, or favorite channel features. For regular sports watching on a PC, Kodi with the IPTV Simple Client plugin is a better option.

How to use M3U files with Kodi

Kodi is the most flexible IPTV media center for PC, Mac, and Android. It supports M3U playlists through the PVR IPTV Simple Client plugin.

In Kodi, go to Settings (gear icon), then Add-ons, then Install from repository, then Kodi Add-on repository, then PVR clients, then PVR IPTV Simple Client. Install it.

Once installed, go to Settings, then PVR and Live TV, then General, and enable Live TV. Then go back to Add-ons, find PVR IPTV Simple Client, and open Settings. In the M3U Playlist URL field, paste your WebflowMT M3U URL. Save. Kodi will download the playlist and channels will appear in the TV section of the main menu.

Kodi also supports EPG via an XMLTV URL. WebflowMT's support team can provide the XMLTV EPG URL for use with Kodi if you want schedule data alongside the channels.

How to use M3U files with IPTV Smarters

IPTV Smarters Pro is the most popular dedicated IPTV app for Android, iOS, and Android TV. It supports both M3U and Xtream Codes, which makes it versatile.

To add an M3U playlist in IPTV Smarters: open the app, tap "Add User," then choose "Load Your Playlist or File/URL." Enter a name for the playlist (e.g., "WebflowMT"), then paste your M3U URL in the Playlist URL field. Tap Add User. The app downloads the playlist and channels appear.

To add Xtream Codes in IPTV Smarters instead: tap "Add User," then choose "Xtream Codes Login." Enter a name, then fill in the Xtream Codes URL, username, and password from your WebflowMT welcome email. This is the recommended method for accessing EPG, VOD, and catch-up features.

Why Xtream Codes is usually better for regular users

To summarize the practical difference: if you are a regular user who wants to set up IPTV once and have it work reliably forever without maintenance, use Xtream Codes. You get an EPG, your channel list updates automatically, VOD and catch-up work, and the experience in apps like TiviMate or IPTV Smarters is polished.

If you are a technical user who wants to load channels into non-standard software, process the list programmatically, or use a media player that does not support Xtream Codes, use M3U.

Because WebflowMT provides both formats, you do not need to choose one at subscription time. Your welcome email contains both the M3U URL and the Xtream Codes credentials. You can use M3U in VLC on your laptop and Xtream Codes in TiviMate on your Android TV box simultaneously.

Common M3U issues and how to fix them

M3U playlist won't load: Check that the URL is exactly as provided, with no extra spaces or line breaks. M3U URLs are case-sensitive in some components. Try pasting the URL into a browser first to confirm it returns a text file.

Channels appear but don't play: The stream URL within the M3U may have changed. Contact WebflowMT support for a refreshed M3U URL. This is less common with Xtream Codes, which always serves current URLs.

No EPG / program guide: M3U playlists need a separate XMLTV EPG URL configured in your app. WebflowMT support can provide this. Alternatively, switch to Xtream Codes login, which delivers EPG data automatically.

Buffering: Not an M3U issue specifically. See the buffering troubleshooting section in the sports IPTV guide.

WebflowMT: both formats, one subscription

WebflowMT has been providing IPTV since 2019 from Malta. The service includes 5500+ live channels, 8000+ VOD titles, and covers 40+ countries. It provides both M3U and Xtream Codes in every subscription.

Plans start from €5/month. A free 24-hour trial is available at webflowmt.com/shopwith no credit card required. Try M3U in VLC or Xtream Codes in IPTV Smarters before deciding which setup you prefer.

Frequently asked questions

What is an M3U playlist?

A plain text file containing a list of stream URLs. Each entry points to an IPTV channel stream. When loaded into an IPTV app, the app presents these as a navigable channel list.

What is the difference between M3U and Xtream Codes?

M3U is a static file with stream URLs. Xtream Codes is a login-based API that dynamically delivers channel lists, EPG, VOD, and catch-up. Xtream Codes updates automatically; M3U requires a new file when URLs change.

How do I use an M3U file with VLC?

Go to Media, Open Network Stream, paste your M3U URL, and click Play. Use the Playlist window (View, Playlist) to navigate between channels.

Does WebflowMT provide M3U playlists or Xtream Codes?

Both. Your welcome email includes the M3U URL and the Xtream Codes credentials. Use either format with your preferred app or device.

Why do M3U playlists sometimes stop working?

M3U files contain static stream URLs. If the server-side URL changes, the entry becomes invalid. Xtream Codes handles this automatically. Request a refreshed M3U URL from WebflowMT support if your playlist breaks.