guides ·

M3U Playlist Guide: What It Is, How to Use It for IPTV (2026)

Learn what M3U playlists are, how they work for IPTV, how to load them in players, and the differences between M3U, M3U8, and Xtream Codes.

If you have looked into IPTV, you have seen the term “M3U playlist” everywhere. It is the most common format for delivering IPTV channel lists and is supported by virtually every IPTV player app. But what exactly is an M3U file? How do you use one? And how does it compare to Xtream Codes API?

This guide explains everything you need to know about M3U playlists for IPTV — what they are, how they work, how to load them in every major IPTV app, and when to use M3U versus Xtream Codes.

Need an IPTV service that provides M3U playlists? IPTVBROS supplies both M3U and Xtream Codes credentials with every subscription. Start a free 24-hour trial to test with 15,000+ channels.

What Is an M3U Playlist?

M3U stands for MP3 URL (though it now extends far beyond MP3 files). It is a plain-text file format that stores a list of media file locations — in the case of IPTV, a list of live TV channel stream URLs.

An M3U file is essentially a text document that tells your IPTV player: “Here are all the channels, organized into groups, with these names and these stream URLs.”

What an M3U File Looks Like

Here is a simplified example of what an IPTV M3U file contains:

#EXTM3U
#EXTINF:-1 tvg-id="CNN.us" tvg-name="CNN" tvg-logo="http://logo.url/cnn.png" group-title="USA News",CNN
http://server.example.com:8080/username/password/12345
#EXTINF:-1 tvg-id="ESPN.us" tvg-name="ESPN" tvg-logo="http://logo.url/espn.png" group-title="USA Sports",ESPN
http://server.example.com:8080/username/password/12346
#EXTINF:-1 tvg-id="BBC1.uk" tvg-name="BBC One" tvg-logo="http://logo.url/bbc1.png" group-title="UK Channels",BBC One
http://server.example.com:8080/username/password/12347

Breaking Down the Format

ElementMeaning
#EXTM3UHeader that identifies the file as an M3U playlist
#EXTINF:-1Extended information tag for each channel (-1 means live stream)
tvg-idEPG identifier — links the channel to program guide data
tvg-nameDisplay name for the channel
tvg-logoURL to the channel’s logo image
group-titleCategory group (e.g., “USA Sports,” “UK News”)
Channel name after commaThe visible channel name in your IPTV app
URL on next lineThe actual stream URL that your player connects to

M3U URL vs M3U File

There are two ways to deliver an M3U playlist:

M3U URL (Remote): A link to an M3U file hosted on your IPTV provider’s server. The URL typically looks like:

http://server.example.com:8080/get.php?username=YOUR_USER&password=YOUR_PASS&type=m3u_plus&output=ts

When your IPTV app opens this URL, the server generates the M3U file on the fly and sends it to your app.

M3U File (Local): A file downloaded to your device (usually with a .m3u or .m3u8 extension). Some users download the file for offline loading or for editing the playlist before importing it.

Most IPTV apps support both methods. M3U URLs are more common because they always reflect the latest channel list from your provider.

M3U vs M3U8: What Is the Difference?

You will sometimes see references to M3U8 alongside M3U. Here is the difference:

FeatureM3UM3U8
EncodingLatin-1 (ISO 8859-1)UTF-8
Character supportLimited (Western characters)Full Unicode (all languages)
UsageTraditional IPTV playlistsModern IPTV, HLS streaming
CompatibilityUniversalUniversal
File extension.m3u.m3u8

In practice for IPTV: M3U and M3U8 are functionally identical. M3U8 uses UTF-8 encoding, which means it can properly display channel names in non-Latin characters (Arabic, Chinese, Cyrillic, etc.). Modern IPTV providers almost always use M3U8 encoding even if the file extension says .m3u.

You do not need to worry about this distinction. Both work in all major IPTV players.

How to Get Your M3U Playlist URL

Your IPTV provider supplies your M3U URL when you subscribe. Here is where to find it:

  1. Welcome email. Most providers, including IPTVBROS, send your M3U URL (along with Xtream Codes credentials) in the welcome email after purchase.
  2. Provider’s website/dashboard. Log in to your account on your provider’s website to find your M3U link.
  3. Provider’s support. Contact customer support if you cannot find your M3U URL.

Important: Your M3U URL contains your username and password. Do not share it with anyone.

How to Load an M3U Playlist in Every Major IPTV App

TiviMate

  1. Open TiviMate.
  2. Go to Settings > Playlists > Add Playlist.
  3. Select M3U Playlist.
  4. Enter your M3U URL.
  5. Click Next and wait for the playlist to load.

For the full TiviMate guide, see our TiviMate setup guide.

IPTV Smarters Pro

  1. Open Smarters Pro.
  2. Select Load Your Playlist or File/URL.
  3. Enter a playlist name and your M3U URL.
  4. Click Add User.

For more details, see our IPTV Smarters Pro guide.

VLC Media Player (Windows/Mac)

  1. Open VLC.
  2. Go to Media > Open Network Stream (Ctrl+N on Windows, Cmd+N on Mac).
  3. Paste your M3U URL.
  4. Click Play.
  5. Open the playlist panel (View > Playlist) to see all channels.

See our Windows IPTV guide for more VLC tips.

Kodi

  1. Open Kodi.
  2. Go to Add-ons > PVR Clients > PVR IPTV Simple Client > Configure.
  3. Set Location to Remote Path (Internet address).
  4. Enter your M3U URL.
  5. Click OK and restart Kodi.

Smart IPTV (Samsung/LG TV)

  1. Open Smart IPTV and note the MAC address displayed.
  2. On your phone/computer, go to siptv.app/mylist.
  3. Enter the MAC address and your M3U URL.
  4. Click Send.
  5. Restart Smart IPTV on your TV.

See our Samsung TV guide or LG TV guide for more details.

SS IPTV (LG TV)

  1. Open SS IPTV and get the one-time code from Settings.
  2. Go to ss-iptv.com/users/playlist.
  3. Enter the code and your M3U URL.
  4. Click Add.
  5. Restart SS IPTV.

MyIPTV Player (Windows/Xbox)

  1. Open MyIPTV Player.
  2. Go to Settings > Add new playlist and EPG source.
  3. Enter your M3U URL.
  4. Click Add.

See our Xbox IPTV guide for more.

GSE Smart IPTV (iOS/Apple TV)

  1. Open GSE Smart IPTV.
  2. Go to Remote Playlists > + (Add).
  3. Enter a name and your M3U URL.
  4. Tap Save.

See our Apple TV guide and iOS setup guide.

M3U vs Xtream Codes API: Which Should You Use?

Both M3U and Xtream Codes connect you to the same IPTV service — the difference is how they communicate with the server.

Comparison

FeatureM3U PlaylistXtream Codes API
Login methodSingle URLServer URL + Username + Password
Channel loadingDownloads entire playlist at onceLoads categories on demand
Loading speed (large lists)Slower (15,000+ channels = large file)Faster (loads incrementally)
Channel categoriesYes (from group-title tags)Yes (from server)
EPGRequires separate EPG URL sometimesUsually included automatically
VOD sectionLimited or noneFull VOD library
Series sectionNoYes (with episode tracking)
Catch-Up TVUsually not availableAvailable (if provider supports it)
Playlist editingEasy (text file)Not possible
Universal compatibilityAll IPTV appsMost IPTV apps (not all)
Best forUniversal compatibility, custom editingFull-featured IPTV experience

When to Use M3U

  • Your IPTV app does not support Xtream Codes (e.g., VLC, some smart TV apps).
  • You want to edit your playlist (add, remove, or reorder channels).
  • You need to share a filtered playlist with a specific device.

When to Use Xtream Codes

  • Your app supports it (TiviMate, Smarters Pro, most modern IPTV apps).
  • You want the best experience with organized categories, VOD, series, and Catch-Up TV.
  • You want faster channel loading with large channel lists.

Our recommendation: Use Xtream Codes whenever your app supports it. Fall back to M3U when Xtream Codes is not an option.

For a complete Xtream Codes guide, see our Xtream Codes API guide.

How to Edit an M3U Playlist

One advantage of M3U over Xtream Codes is that you can edit the playlist to customize your channel list.

Downloading Your M3U File

  1. Open your M3U URL in a web browser.
  2. The browser will either display the text or download the file.
  3. If it displays text, right-click and Save As with a .m3u extension.
  4. If it downloads, you now have the file.

Editing with a Text Editor

M3U files are plain text. You can edit them with any text editor:

  • Windows: Notepad, Notepad++, VS Code.
  • Mac: TextEdit (set to plain text mode), VS Code, Sublime Text.
  • Linux: nano, gedit, VS Code.

Common Edits

Remove unwanted channels: Delete both the #EXTINF line and the URL line below it for any channel you do not want.

Reorder channels: Cut and paste channel blocks (the #EXTINF line + URL line) to change the order.

Change group names: Modify the group-title="..." value to reorganize channels into custom categories.

Remove entire categories: Delete all channels with a specific group-title value.

Saving and Loading Your Edited Playlist

After editing, save the file and load it into your IPTV app as a local file (not as a URL). Note that any changes your IPTV provider makes to the channel list will not be reflected in your edited file — you would need to re-download and re-edit if they update their server.

M3U Playlist Troubleshooting

Playlist Not Loading

  • Verify the M3U URL is complete and correct.
  • Test the URL in a web browser. If it downloads a file or shows text starting with #EXTM3U, the URL is valid.
  • Check your internet connection.
  • Ensure your IPTV subscription is active.

Channels Missing from Playlist

  • Your provider may have reorganized channels. Re-download or re-add the playlist URL.
  • If you are using an edited local file, you may have accidentally deleted channels. Re-download the original.

Playlist Loading Very Slowly

  • Large playlists (15,000+ channels) can take 1 to 5 minutes to load. This is normal.
  • Xtream Codes loads faster because it does not download the entire list at once. Consider switching if your app supports it.
  • Ensure your internet connection is stable during the loading process.

EPG Not Matching Channels

  • EPG channel IDs (tvg-id values) must match the EPG source data. If they do not match, the EPG will appear empty for those channels.
  • Use the EPG URL provided by your IPTV service rather than a third-party EPG source.
  • Contact your provider if EPG data is consistently missing.

For more troubleshooting, see our IPTV not working fix guide.

Frequently Asked Questions

Is an M3U playlist the same as an IPTV subscription?

No. An M3U playlist is a format for delivering the channel list. The IPTV subscription is the service that provides the content. You need a subscription from a provider like IPTVBROS to get an M3U playlist URL that actually works.

Can I create my own M3U playlist?

You can create an M3U file and add stream URLs to it, but you need valid stream URLs from an IPTV provider. You cannot create channels from nothing.

Is sharing my M3U URL safe?

No. Your M3U URL contains your login credentials. Anyone with the URL can use your IPTV subscription. Keep it private.

How often should I update my M3U playlist?

If you use an M3U URL (remote), it updates automatically each time your app refreshes. If you use a downloaded M3U file (local), you should re-download it periodically (weekly or monthly) to get the latest channel list.

Can I use multiple M3U playlists in one app?

Yes. Most IPTV apps support multiple playlists. TiviMate Premium, IPTV Smarters Pro, and GSE Smart IPTV all allow you to add and switch between multiple playlists.

Related Articles

Ready to Start Watching?

Try IPTVBROS free for 24 hours. No commitment, cancel anytime.

No credit card required · Cancel anytime

Browse Plans WhatsApp