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.
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

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.
| Variant | Looks like | What the player shows |
|---|---|---|
| Basic M3U | One path or URL per line, no header | The raw URL as the item name |
| Common / extended M3U | Header + an #EXTINF line before each location | Channel name, logo, and group |
| M3U8 | Same structure, saved as UTF-8 | Same, 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
| Part | Example | Required | Effect |
|---|---|---|---|
| Header | #EXTM3U | Yes in practice | Marks the file as extended so attributes are read |
| Tag | #EXTINF:-1 | Yes | Starts an entry; the number is the duration in seconds |
| Attributes | tvg-id="…" group-title="…" | No | Guide matching, logo, grouping |
| Separator | , | Yes | Ends the attributes; everything after it is the display name |
| Name | BBC One | Recommended | What the player shows in the list |
| Location | https://…/index.m3u8 | Yes | The stream or file the player opens |
Mistakes That Break a Common Playlist
| Symptom | Cause | Fix |
|---|---|---|
| Every item named after its URL | Missing #EXTM3U header, or an #EXTINF line without a comma | Add the header; end each #EXTINF line with a comma before the name |
| Name cut in half | A comma inside the display name | Quote the attribute values, keep one comma before the name |
| Only the first channel appears | Blank line or stray character between entries | Keep entries contiguous; no text between an #EXTINF line and its URL |
| Accented names become symbols | File saved as ANSI | Save as UTF-8 and use .m3u8 |
| Channels duplicate every refresh | Playlist merged or re-imported twice | De-duplicate with the removal guide below |
| Works on desktop, not on TV | Local paths in a network-only player | Use 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:
- M3U Validator — missing headers, entries without a location, malformed
#EXTINFlines, duplicate URLs. - M3U Editor — rename channels, fix logos, regroup, export a clean file.
- M3U Merger — combine two common playlists without duplicates.
- Remove duplicate channels — the manual method and what causes duplicates.
- How to open an M3U file — if the playlist is valid but the wrong app opens it.
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?
Sources: M3U format specification, iptv-org playlist project