Setup guide

M3U Playlist Explained: What It Is and How to Use It

An M3U playlist is a simple text file that lists streams and tells a player app where to find them. When a provider gives you an "M3U link", they are giving you the address of that list.

M3U has been around since the early days of digital music, when it was used to list MP3 files. The format is so simple and widely supported that it became a standard way to deliver IPTV channel lists. Almost every IPTV player can read one, which is why it is still one of the most common login methods.

What is inside an M3U file

If you opened an M3U file in a text editor, you would see a list of entries. Each channel usually has a line of information, starting with #EXTINF, followed by a line containing the stream address. The information line can include the channel name, a logo, the group it belongs to and an ID used to match the TV guide. An extended M3U file starts with #EXTM3U at the top.

You do not need to edit any of this. Your player app reads it and turns it into a tidy channel list with groups and logos.

M3U link versus M3U file

Providers usually supply a link (a URL) rather than a file. A link is better because the list can be updated on the provider's side; when channels are added or changed, your app picks up the changes when it refreshes. A downloaded file stays frozen at the moment you saved it.

How to add an M3U playlist to a player

1. Open your player app and choose to add a new playlist or user.
2. Select the M3U or "playlist URL" option. Some apps call it "Load your playlist or file/URL".
3. Enter a name so you can recognise the playlist later.
4. Paste or type the full link exactly as supplied, including every character after the question mark.
5. Add the EPG link if the app asks for one and your provider supplied it.
6. Save and wait while the app downloads the list and sorts channels into groups.

Typing long links on a TV remote is fiddly. Many apps let you add the playlist from a phone or computer, or you can use the Xtream Codes login instead, which is shorter. Our guide to Xtream Codes logins explains the difference.

Fixing common M3U errors

• "Invalid playlist" or "no channels found". Usually a typing error. Check capital letters, the difference between the letter O and zero, and that nothing was cut off.
• The list loads but channels will not play. The account may have expired, or the device limit may be reached. Close the app on other devices and try again.
• Very slow loading. Large lists take time on older devices. Let the first load finish fully; later refreshes are usually quicker.
• No guide information. Add the separate EPG (XMLTV) link in the app's guide settings.

Keeping your link private

Your M3U link contains your login details. Anyone with it can use your account, which could hit your device limit or lead to suspension. Do not post it in forums or share screenshots that show it.

M3U questions

Can I open an M3U link on a computer?

Yes. Players such as VLC can open an M3U link directly on Windows and Mac.

Is M3U better than Xtream Codes?

Neither is better for picture quality. Xtream Codes is often quicker to enter and can load on-demand content more neatly.

How often should the playlist refresh?

Once a day is plenty for most people. Many apps let you set automatic refresh.

An M3U link is simply the address of your channel list. Enter it carefully, add the EPG link if you have one and keep it private.