Aquar Player
HomeGuides › M3U playlists

What is an M3U playlist?

It is a text file. That is genuinely all it is — and once you can read one, most playlist problems answer themselves.

The file, opened

An M3U playlist starts with one header line, then repeats two lines per channel:

#EXTM3U
#EXTINF:-1 tvg-id="bbc1.uk" tvg-logo="http://host/bbc1.png" group-title="UK | GENERAL",BBC One HD
http://server.com:8080/live/user/pass/12345.ts

Line one describes the channel. Line two is where the video lives. Repeat a few thousand times and you have a full playlist — often 30 MB of text, which is why some apps take a while to open one.

What each part means

PartRoleIf it is missing
#EXTM3Umarks the file as a playlistplayers refuse the file
#EXTINF:-1duration; −1 means livethe entry is ignored
tvg-idlinks the channel to the programme guideno EPG on that channel
tvg-logothe channel logoa blank tile
group-titlethe categoryeverything lands in one giant list
after the commathe displayed namenothing readable

M3U or M3U Plus?

M3U Plus is the same file with those attributes filled in. A plain M3U has only names and addresses: no logos, no categories, no guide. Providers almost always offer both — the link usually ends with type=m3u_plus. Always ask for that one.

Reading your own link

Most subscriptions arrive as a single long URL:

http://server.com:8080/get.php?username=abc123&password=xyz789&type=m3u_plus&output=ts

Those first three items are also your Xtream Codes credentials, which give a far better experience from the same subscription.

The usual problems

“The playlist loads but nothing plays”

The list downloaded fine, so your line is valid. The streams are refused — most often because the subscription's device limit is already in use elsewhere.

“Half the channels are missing”

Either the package does not include them, or the file was truncated during download. A playlist saved to a file goes stale; the link stays up to date, so paste the link rather than a downloaded copy.

“Everything is in one giant category”

No group-title — a plain M3U. Ask for the m3u_plus link.

“The guide is empty”

The tvg-id values do not match any guide source. With Xtream credentials the guide comes from the server directly, which avoids the problem entirely.

Free public playlists

Open collections of freely broadcast channels exist — public broadcasters, regional and community channels — and they are perfectly legal because those channels are meant to be free. They are a good way to test a player before paying for anything. What they are not is a replacement for a subscription, and any list promising paid channels for free is not one of them.

Can you edit one?

Yes — it is text. You can rename channels, reorder them, or delete groups you never watch, with any editor. Keep three things intact: the #EXTM3U first line, the pairing of each #EXTINF with its address, and the file saved as plain .m3u. In practice, favorites inside a good player achieve the same result without touching the file.