Format basics

What is an M3U file? Format, structure, and how it works

What is an M3U file? An M3U file is a plain-text playlist in the M3U format. A player reads its entries in order and attempts to open the media location written after each entry.

M3U foundations7 min read

The core idea

M3U began as a playlist format for audio software and is now used more broadly by compatible media players. The format is easy to inspect because it is text, not a special database or locked container.

Each item normally has optional information beginning with a hash and a following line containing a local path or URL. Players may ignore metadata they do not understand, so simple, clean entries are a dependable starting point.

M3U file, M3U format, M3U playlist — same thing?

These terms describe the same idea from different angles. The file is the text document you save, the format is the plain-text convention it follows, and the playlist is what a player shows after reading it. You do not need a separate guide for each term.

A minimal, authorized example

This example uses a placeholder address. Replace it only with a file or source you own, license, or are expressly allowed to use.

Example M3U playlist
#EXTM3U
#EXTINF:-1,Sample documentary
https://media.example.org/authorized/sample-documentary.mp4

Anatomy of a typical playlist

Most small, well-formed playlists share the same common lines. Learning to recognize them makes it easier to spot a typo without guessing.

  • #EXTM3U: optional header many players use to recognize an extended playlist.
  • #EXTINF: describes the next item, usually with duration and a human-readable name.
  • Media location: exactly one local path or authorized URL on the next line.
  • Comments and blank lines: players typically ignore them, but keep them tidy.

What the lines do

#EXTM3U is an optional header that tells many players this is an extended playlist. #EXTINF describes the next item, and the following line is the location the player should open.

  • Keep one media location per line.
  • Use UTF-8 text encoding when possible.
  • Give entries clear, human-readable names.
  • Treat an inaccessible URL as an authorization or availability issue, not a cue to work around controls.

Quick answers

Common questions

Is M3U a media format?

No. It is a playlist format. The playlist can point to many kinds of compatible audio or video media.

What is the M3U file format?

It is a plain-text convention for listing media locations in order, with optional hash-prefixed metadata such as #EXTM3U and #EXTINF. Save it as UTF-8 text with one location per line.

What does a common M3U playlist contain?

Usually a header, repeating pairs of description lines and media locations, and nothing else. If entries look unfamiliar, inspect them in a text editor before importing.

Can I open an M3U file in a text editor?

Yes. A plain-text editor is a useful way to inspect the lines, correct an entry, and save a small playlist using UTF-8 encoding.