An M3U playlist is a plain text file listing channel names and the web address of each channel's stream. Your provider gives you a URL that generates one for your account, and any player can load it. Because that URL contains your login, anyone who has it can watch on your account — which is why it should never be posted publicly.
What is actually inside an M3U file
It is text. You can open yours in a browser and read it. A single channel entry looks roughly like this:
#EXTM3U | The header. Marks the file as a playlist. |
#EXTINF:-1 tvg-id="bbc1.uk" tvg-logo="…" group-title="UK",BBC One | Channel metadata — its guide ID, logo, group and display name. |
http://server:8080/user/pass/12345 | The stream address for that channel, containing your username and password. |
That pattern repeats once per channel. A line-up of 18,000 channels is a file of about 54,000 lines, which is why it takes a moment to load.
Three practical consequences fall out of this structure:
- The playlist is not the guide.
tvg-idonly points at guide data held elsewhere — which is why channels can load with an empty EPG. See guide problems. - One dead channel does not mean a dead service. Each line is an independent address; one can fail while every other works.
- Your credentials are in every line. Which brings us to the next section.
M3U or Xtream Codes — which to use
Most providers, ours included, give you both. They are two ways of reaching the same account.
| M3U URL | Xtream Codes login | |
|---|---|---|
| What you enter | One long web address | Username, password and server URL |
| Player support | Almost universal | Most modern players, not all |
| Programme guide | Often needs a separate EPG URL | Included automatically |
| On-demand library | Usually mixed into the channel list | Separate, browsable section |
| Updating the list | Manual refresh in some players | Updates automatically |
Use the Xtream Codes login wherever the player supports it, and keep the M3U URL for players that do not. Both are explained further in the Xtream Codes guide.
Loading a playlist in any player
| Player | Where to paste it |
|---|---|
| IPTV Smarters | Load Your Playlist or File/URL → paste the link |
| TiviMate | Add playlist → M3U playlist → paste |
| Kodi | PVR IPTV Simple Client → M3U Play List URL |
| VLC | Media → Open Network Stream → paste |
| Smart TV players | Often through the app's own web portal after pairing the TV |
If a player rejects the link, how to check an M3U URL walks through the usual causes.
Free public playlists
Publicly available M3U playlists exist, and the legitimate ones collect channels that broadcasters stream openly on their own websites. They are lawful to watch, free, and unreliable by nature.
- Links rot. Broadcasters change stream addresses without notice, so any list is partly dead within weeks.
- There is no guide. Public lists rarely carry usable EPG data.
- There is nobody to ask. No support, no uptime, no accountability.
- Quality is whatever the broadcaster publishes, which is often below HD.
They are genuinely useful for one thing: testing a player before you have a subscription. For anything you intend to sit down and watch, they are not a substitute — a real trial tells you far more.
Frequently asked questions
What is an M3U playlist?
A plain text file listing channel names and the web address of each stream. Your provider gives you a URL that generates one for your account, and any player can load it.
Is it safe to share my M3U link?
No. It contains your username and password, so anyone with it can watch on your account. Most providers suspend lines that are shared publicly.
Why do my channels load but the guide is empty?
The playlist and the guide are separate. An M3U link often needs an EPG URL added alongside it — here is how.
Are free M3U playlists legal?
Playlists of channels that broadcasters stream openly are legal. Lists of paid channels redistributed without permission are not, and they also stop working quickly.
Last reviewed September 22, 2026 by The HakunaXTR team · About the team
