What Is an M3U Playlist?

What Is an M3U Playlist? How It Works and How to Use It

An M3U playlist is a plain-text file listing where audio, video, radio, or live streams are located. It normally stores directions, not the media itself. A compatible player reads those directions and plays each item.

What Is an M3U Playlist and What Does It Contain?

An M3U file can point to media on a device, network, or website. Entries contain file paths or URLs. Extended playlists may add titles, durations, groups, logos, or channel identifiers.

Basic M3U Files

A basic playlist can contain one location per line:

C:\Music\Track-One.mp3

C:\Music\Track-Two.mp3

https://media.example.com/radio-stream

Local entries stop working if files are moved, renamed, or unavailable on another device. VideoLAN describes basic M3U playlists as containing one entry per line.

Extended M3U Files

An Extended M3U playlist starts with #EXTM3U. A #EXTINF line describes the entry below it. IPTV playlists may also contain channel names, groups, logos, and EPG identifiers. Kodi documents this structure for live TV playlists.

#EXTM3U

#EXTINF:180,Example Audio Track

Here, 180 is the duration in seconds. The last line is the media URL.

How Does an M3U Playlist Work?

A player reads the playlist, follows each path or URL, and requests the media. The player handles playback, while the playlist acts as an index. Deleting the playlist does not delete the original media.

One online entry may fail even when the remaining playlist works. This can happen when the individual file or stream is unavailable.

What Are M3U Playlists Used For?

Local Music and Video Playlists

M3U files arrange songs, recordings, or videos without duplicating them. Users can save a preferred playback order and reopen it later in a compatible player.

Internet Radio, IPTV, and Online Streaming

M3U playlists can list radio stations, live TV channels, and other network streams. IPTV is only one use. The playlist supplies media locations, while the player provides the interface and playback controls.

What Is the Difference Between M3U, M3U8, and HLS?

M3U vs. M3U8

Both are text-based playlist formats. An .m3u8 file explicitly uses UTF-8 encoding, which handles accented and non-Latin characters consistently. An .m3u file may use another text encoding.

How HLS Uses M3U8 Playlists

HTTP Live Streaming, or HLS, uses M3U8 playlists to reference media segments or alternative stream versions. A player can switch between different bit rates or resolutions as network conditions change.

RFC 8216 requires HLS playlists to use UTF-8. Apple describes M3U8 as an extension of the M3U format and explains that HLS playlists list media-segment URLs in playback order.

Format	Main Purpose	Encoding	Contains Media?
M3U	General media playlists	Varies	No
M3U8	UTF-8 media playlists	UTF-8	No
HLS M3U8	Segmented online streaming	UTF-8	No

How Do You Open or Use an M3U Playlist?

Opening an M3U File

1. Save the .m3u or .m3u8 file.
2. Open a compatible player, such as VLC or Kodi.
3. Choose the option to open a file or playlist.
4. Select the playlist and start an entry.

The player must support the referenced media format or streaming protocol. VideoLAN describes VLC as a cross-platform player that supports multimedia files and various streaming protocols.

Adding an M3U URL to a Player

Copy the complete playlist URL, open the player’s playlist settings, select the remote URL option, and paste the address. Refresh the playlist when its source changes.

Do not publish private M3U URLs. Some URLs contain usernames, access tokens, or other account details.

What Is the Difference Between an M3U Playlist, an IPTV Player, and an EPG?

Component	Purpose
M3U playlist	Lists channel or media locations
IPTV or media player	Reads the playlist and plays streams
EPG	Provides programme names, times, and schedules
Content source	Hosts or delivers the media

Installing a player does not automatically provide channels. Kodi’s IPTV Simple Client uses an M3U playlist as its live-stream source and XMLTV as its EPG source. Playlist identifiers can help match channels with their programme-guide records.

M3U vs. Xtream Codes: What Is the Difference for IPTV Users?

Area	M3U	Xtream Codes-Style Login
Setup	Playlist file or URL	Server, username, and password
EPG	Often configured separately	May load with account information
Credentials	May appear inside the URL	Entered into separate fields
Compatibility	Requires M3U support	Requires a compatible login option

Support varies between players. Both methods provide access information to an application, but neither proves that a service has legal distribution rights. Kodi’s IPTV Simple project also documents Xtream Codes URL handling alongside M3U and XMLTV features.

Can You Create or Edit an M3U Playlist?

Yes. Enter one valid path or URL per line in a plain-text editor, then save the file with an .m3u extension. Save an M3U8 file using UTF-8 encoding.

Add #EXTM3U and #EXTINF when titles, durations, channel details, or other metadata are required. Check every path before saving, especially after moving media to a different folder or device.

Are M3U Playlists Safe and Legal?

M3U is a neutral file format. Legality depends on whether you have permission to access, use, or distribute the referenced content. Use playlists from authorized sources and follow the copyright and streaming rules in your location.

Avoid unknown playlist downloads, keep your media player updated, and protect URLs containing credentials. A playlist can direct your player to external servers, so its source matters.

Why Is My M3U Playlist Not Working?

Check these common causes:

• The playlist address is incorrect or expired.
• A referenced stream is offline.
• Local media was moved or renamed.
• The network location is unreachable.
• Tags are malformed.
• The text encoding is unsupported.
• The remote playlist needs refreshing.
• EPG data was not configured separately.
• The player does not support the stream format.

If one entry fails, test another. If everything fails, check the playlist URL, internet connection, access details, and player settings.

How to Fix “M3U URL Not Working”

Conclusion

An M3U playlist is a lightweight set of directions for a media player. Separating the playlist from the player, EPG, and actual content source makes setup and troubleshooting much easier.

Frequently Asked Questions