M3UExamplesReference

Common M3U Playlist: Format & Copy-Paste Examples

A common M3U playlist is an extended M3U file: an #EXTM3U header, then one #EXTINF line per entry followed by its stream URL or file path. Below are complete working playlists for IPTV, radio and local files that you can copy as-is, plus what each line does and the mistakes that break them.

Updated November 13, 20266 min readReviewed by Alex Morganby Alex Morgan

The common format, in full

One header line, then two lines per entry: the #EXTINF line with a comma before the display name, and the location on the next line.

#EXTM3U
#EXTINF:-1,BBC Radio 1
http://stream.example.com/bbc1.mp3
A common M3U playlist with header, EXTINF lines and stream URLs

What Makes It the “Common” Format

Two features separate the common (extended) playlist from the original format: the #EXTM3U header on the first line, and an #EXTINF line before every entry. The header declares the file as extended M3U. The #EXTINF line carries the duration and the display name, plus optional attributes a player can use.

VariantLooks likeWhat the player shows
Basic M3UOne path or URL per line, no headerThe raw URL as the item name
Common / extended M3UHeader + an #EXTINF line before each locationChannel name, logo, and group
M3U8Same structure, saved as UTF-8Same, but non-English names survive

For the full attribute list, see the M3U file format reference. If your names contain accents, Cyrillic, or Arabic, save the file as M3U8 instead — see M3U vs M3U8.

Common M3U Playlist for IPTV

This is the shape you will see in almost every IPTV playlist. The attributes are what make it usable on a TV:

#EXTM3U #EXTINF:-1 tvg-id="bbcone.uk" tvg-name="BBC One" tvg-logo="https://example.com/logos/bbcone.png" group-title="UK",BBC One https://stream.example.com/bbcone/index.m3u8 #EXTINF:-1 tvg-id="cnn.us" tvg-name="CNN" tvg-logo="https://example.com/logos/cnn.png" group-title="News",CNN https://stream.example.com/cnn/index.m3u8

tvg-id links the channel to an EPG listing, tvg-logo supplies the icon, and group-title decides which folder the channel lands in. Drop any of them and the playlist still plays, but you lose the guide, the logos, or the grouping. The M3U tags reference covers each attribute in detail.

Common M3U Playlist for Radio and Audio

Audio playlists usually need nothing but a name and a URL. This is also the shortest valid extended playlist:

#EXTM3U #EXTINF:-1,BBC Radio 1 http://stream.live.vc.bbcmedia.co.uk/bbc_radio_one #EXTINF:-1,NPR News https://npr-ice.streamguys1.com/live.mp3

The -1 duration tells the player the length is unknown, which is correct for a live stream. Putting a real number there is harmless for playback but misleading in the interface.

Common M3U Playlist for Local Files

Local playlists are the original use case. Here the duration is known, so it is included in seconds:

#EXTM3U #EXTINF:233,Nirvana - Come as You Are C:\Music\Nirvana\ComeAsYouAre.mp3 #EXTINF:242,Radiohead - Creep C:\Music\Radiohead\Creep.mp3

Backslashes are Windows paths; on macOS and Linux use forward slashes. Absolute paths only work on the machine that created them — if you want the playlist to survive a move, use paths relative to the playlist file itself, which is covered in the format reference.

What Each Line Does

PartExampleRequiredEffect
Header#EXTM3UYes in practiceMarks the file as extended so attributes are read
Tag#EXTINF:-1YesStarts an entry; the number is the duration in seconds
Attributestvg-id="…" group-title="…"NoGuide matching, logo, grouping
Separator,YesEnds the attributes; everything after it is the display name
NameBBC OneRecommendedWhat the player shows in the list
Locationhttps://…/index.m3u8YesThe stream or file the player opens

Mistakes That Break a Common Playlist

SymptomCauseFix
Every item named after its URLMissing #EXTM3U header, or an #EXTINF line without a commaAdd the header; end each #EXTINF line with a comma before the name
Name cut in halfA comma inside the display nameQuote the attribute values, keep one comma before the name
Only the first channel appearsBlank line or stray character between entriesKeep entries contiguous; no text between an #EXTINF line and its URL
Accented names become symbolsFile saved as ANSISave as UTF-8 and use .m3u8
Channels duplicate every refreshPlaylist merged or re-imported twiceDe-duplicate with the removal guide below
Works on desktop, not on TVLocal paths in a network-only playerUse stream URLs, or a player that handles local files

Validate and Edit Before Loading

A malformed playlist tends to fail silently — the player opens it and simply shows less than you expect. Check it first:

All the tools run in your browser and process the file locally, so a playlist containing provider credentials never leaves your machine.

Frequently asked questions

What is a common M3U playlist?

A common M3U playlist is an extended M3U file: it starts with the #EXTM3U header, then lists one #EXTINF line per entry (name plus optional attributes such as tvg-id, tvg-logo and group-title) followed by the file path or stream URL on the next line. The pattern repeats for every channel or track.

How many lines is a common M3U playlist?

Each entry takes exactly two lines — one #EXTINF metadata line and one location line. An empty playlist with the header is one line. A playlist with ten channels is 21 lines: the header plus two per channel.

What is the difference between a basic and an extended M3U playlist?

A basic M3U is just a list of paths or URLs, one per line, with no metadata. An extended M3U adds the #EXTM3U header and an #EXTINF line before each entry so players can show a name, a logo and a group. Almost every playlist you are handed today is the extended kind, which is why it is called the common format.

Does a common M3U playlist need #EXTM3U at the top?

Strictly, no — players will often read a bare list of URLs. In practice, yes: without the header many players treat the file as a plain text list and ignore the #EXTINF attributes, which is how you end up with every channel named after its URL. Always include it.

Why do some entries show as numbers instead of channel names?

The name comes from the text after the comma on the #EXTINF line. If the line is malformed — a missing comma, or a comma inside the name splitting it early — the player falls back to the stream URL or an index number. Check that each #EXTINF line ends with a comma, then the display name.

Can I put local file paths and stream URLs in the same playlist?

Yes. The format does not care what the location is, so a playlist can mix local media and network streams. The practical limit is the player: a TV app that only handles network streams will skip the local paths. For mixed use, VLC and Kodi are the tolerant choices.

How do I check whether my M3U playlist is correctly formatted?

Run it through a validator. It will report a missing header, entries without a location, malformed #EXTINF lines, duplicate URLs, and unclosed quotes in attributes. Fixing those before loading the playlist saves you from debugging a player that is behaving correctly.

Summary

A common M3U playlist is one header line plus two lines per entry. Attributes are optional, the comma before the name is not, and the location line is mandatory. Copy one of the three examples above, replace the URLs with your own, and validate it before you load it.

Related Guides

Quick Reactions

Was this guide helpful?

Share this guide

Sources: M3U format specification, iptv-org playlist project