Guide ยท updated
M3U Playlist: What It Is, How to Use It and Why It Will Not Load
An M3U playlist is a text file that lists streams: a line with each channel's name and details, then the line with its address. You add the playlist's link to an IPTV player, and the player loads the channels from it.
What is inside an M3U playlist?
It starts with #EXTM3U. Every channel then has an #EXTINF line, followed by its stream address:
#EXTM3U url-tvg="http://host.example/xmltv.php"
#EXTINF:-1 tvg-id="news.example" tvg-logo="http://host.example/news.png" group-title="News",News One
http://host.example/live/USERNAME/PASSWORD/1001.ts
group-title is the group a channel is listed under, tvg-logo its logo and tvg-id the ID used to match it to a TV guide. M3U8 is the same format saved as UTF-8 text. To see what a real file contains, open it in the M3U file viewer.
Most playlist links have your username and password in them, as in the example. Treat the link like a password.
What does an M3U link look like?
Most sources run an Xtream Codes panel, so the link usually has this shape:
http://SERVER:PORT/get.php?username=USERNAME&password=PASSWORD&type=m3u_plus&output=ts
type=m3u_plus asks for the playlist with groups, logos and guide IDs; type=m3u for a bare list. output=ts or output=m3u8 picks the stream format. If you have the server, username and password but no link, the Xtream to M3U converter writes it for you.
How do I add an M3U playlist to Opus?
- Copy the whole linkCopy it from the message your source sent rather than retyping it. Links are long and one wrong character breaks them.
- Add a playlistOpen Opus, add a playlist, choose M3U and paste the link.
- Wait for the first loadOpus downloads the playlist and sorts it into Live TV, Movies and Series. Playlists with tens of thousands of entries take longest the first time.
- Move it to a TVTo use the same playlist on Apple TV, Android TV or Fire TV, send it with QR Sync instead of typing it with a remote.
Opus takes playlist links, not files. It shows a TV guide for Xtream Codes logins only, so if your source gave you both, the Xtream login gets you the guide.
M3U link or Xtream Codes login: which should I use?
They are two ways into the same account. An Xtream login (server, username and password) lets the player fetch channels, films, series and the guide separately, which loads faster for large accounts. An M3U link puts everything in one file. Use the Xtream login when the player supports it; use the M3U link when it does not.
Why is my M3U playlist not loading?
Open the link in a web browser first. What you get back tells you where the problem is:
| What the browser shows | What it means | What to do |
|---|---|---|
| A file downloads | The link works | Open the file in the M3U file viewer to check it for errors. If it is fine, the problem is in the player or the device. |
| A web page or login page | The server rejected the login, or the account has expired | Check the account with your source. |
| An empty page or empty file | The account exists but has no channels for this link, or has expired | Try type=m3u instead of m3u_plus, then ask your source. |
| 401 or 403 error | Wrong username or password, or the server blocks this connection | Copy the link again; check whether the source allows this device or network. |
| 404 error | The address is wrong | Check the server, port and the get.php part of the link. |
| Nothing loads, the page times out | The server is down or unreachable from your network | Try again later or from another network. |
If the playlist loads but some channels do not play, the playlist is fine; those streams are offline or blocked, and only the source can fix them.
Frequently asked questions
Where do I get an M3U playlist?
From the service you watch through. Opus does not provide playlists, and lists posted publicly are usually unauthorised and stop working quickly.
Can I open an M3U file in Opus?
No, Opus takes a playlist link or an Xtream Codes login. To look inside a file, use the M3U file viewer; to change one, the M3U editor.
Why do my channels show no TV guide?
In Opus the guide is shown for Xtream Codes logins only, so an M3U playlist plays without one. In other players the guide comes from the url-tvg link in the playlist or a guide link you add.
Is M3U the same as M3U8?
For a channel list, yes: M3U8 is the same format saved as UTF-8 text. The name M3U8 is also used for the HLS file behind a single stream, which is not a channel list.