Setup, login & playlists
What Is an M3U File? The M3U Playlist Explained
An M3U playlist is a plain text list that tells your player what to play. See what's inside one, file versus link, M3U8 and what to check if it won't load.

An M3U file, also called an M3U playlist, is a plain text list of where your channels or videos are, one address per line. It holds no video itself: your player reads the list, shows you the names, and fetches each stream when you press play. An .m3u8 file is the same kind of list, saved as UTF-8 text.
That's really all it is. The rest of this guide explains what's inside one, the difference between an M3U file and an M3U link, where M3U8 fits in, and what to check when a playlist won't load. It applies whatever device you watch on.
What an M3U playlist actually is
M3U started life in the 1990s as a simple playlist format for MP3 music. Because it's just a list of locations, it works just as well for video and live TV, which is why IPTV players use it so widely today.
Think of it as a shopping list rather than the shopping. The list says where each item is and what it's called. Your player does the fetching. So if the list is fine but an address on it no longer works, that channel won't play, however good your player is.
There's no official rulebook for M3U. It's a format everyone copied, so players read the extra details slightly differently. That's why a playlist can look perfect in one app and lose its channel logos or groups in another.
If you're still getting to grips with the basics, our guide to what an IPTV player does explains how the player and the content fit together.
What's inside an M3U file
Open an M3U file in a text editor and you'll see plain lines of text. A playlist made for TV usually follows this pattern, shown here with made-up details:
That pair of lines, a description followed by an address, repeats for every channel or video. A big playlist is simply the same pattern thousands of times.
The optional details are worth knowing about. group-title sorts channels into groups such as News or Films. tvg-logo points to a channel logo. tvg-id is the label the player uses to match each channel with its listings in a separate TV guide. When that label is missing or doesn't match, the channel plays but the guide stays blank, which our guide to fixing IPTV EPG problems covers in detail.
| Line | What it does |
|---|---|
| Header | #EXTM3U on the first line tells the player this is an extended playlist with names and extra details. |
| Details | #EXTINF:-1 tvg-id="news1",Example News describes the next entry: -1 means a live stream with no fixed length, then optional details, then the name you'll see. |
| Address | The web address the player opens when you choose that channel, for example https://example.com/news1 in our made-up list. |
M3U file or M3U link?
You'll usually be given a playlist in one of two forms, and most players ask which one you have.
An M3U link is a web address ending in something like .m3u or carrying the word m3u. The player downloads the list from that address and can download it again later, so changes to the list reach you when the player refreshes.
An M3U file is the same list saved on a device. It doesn't change unless you replace it, and on a TV it can be fiddly to get the file onto the device in the first place.
If you have the choice, a link is usually easier on a TV. Some services give you a server login (address, username and password) instead of a playlist; that's a different way in, and your player needs to support it. Our guide to choosing between a playlist link or Xtream Codes login explains which to use.
M3U or M3U8: what's the difference?
For a channel list, the main difference is text encoding. An .m3u8 file must be saved as UTF-8, which handles accented letters and non-Latin alphabets properly. An older .m3u file may use whatever text setting the computer that made it used, which is why channel names sometimes show odd symbols in place of letters.
There's one catch. M3U8 is also the format used to deliver a single video stream in pieces. So an address ending in .m3u8 might be one channel's stream rather than a list of channels. If a player says your playlist is invalid or shows just one item, that's a likely reason.
Why your M3U playlist opens as text or downloads
Open an M3U link in a web browser and it will either download a small file or show a page of text. That's normal. A browser doesn't play the list; a player app does.
If you want to look inside a playlist file, use a plain text editor, not a word processor, which can add hidden formatting. If you change anything, save it as plain text in UTF-8 and keep the .m3u or .m3u8 ending. Changing the ending on its own doesn't convert anything.
What to check when an M3U playlist won't load
Work through these in order and test after each one. Stop when the channels appear.
- Check the address for typing mistakes, especially look-alike characters such as O and 0, or l and I. Test: refresh the playlist in the player. If channels appear, you're done.
- Open the same link in a browser on your phone. If it downloads a file or shows lines starting with #EXTM3U, the list exists and the problem is on the TV side, so carry on with the next step. If you get an error page, the link itself isn't working, and your TV service's support team is the place to ask.
- If the address ends in .m3u8 and the player shows only one item or calls it invalid, it may be a single stream, not a playlist. Check you've used the playlist address you were given.
- If you're using a playlist file made on a computer, open it and look at the addresses. Lines like C:\Music\track.mp3 point to files on that computer, which the TV can't reach. A playlist only works where every address can be reached from the device playing it.
- If most channels appear but some are missing, the list may contain duplicate tvg-id labels. Some software keeps only one channel per label. Check whether the missing channels share a label with one that did appear.
If none of that helps, write down the exact error and what each test showed, and contact your player's support team. Leave the full link out of anything you send.
What to look for in a player that uses M3U playlists
If you're choosing your first player, a few things make playlists much easier to live with:
- It accepts the form you've been given: an M3U link, a file, a server login, or all three.
- It refreshes a playlist link without you re-entering it.
- It uses each channel's guide label to show what's on now and next.
- It lets you hide groups you never watch and keep favourites, so a long list stays manageable.
- Entering a long address with a TV remote isn't a chore, for example because you can type on your phone.
Keep your playlist link private
Playlist links often contain your username and password inside the address itself, something like username=example&password=example. Treat the link like a password: keep it out of screenshots, forum posts and support emails.
Ready to put one to work? Our step-by-step guide on how to add an IPTV playlist covers what to have ready, how to avoid typing it all with the remote, and what to check if no channels appear. To follow the player we're building, visit the GamGam TV player page.
Frequently asked questions
Is an M3U file the same as an M3U playlist?
Yes. An M3U playlist is simply an M3U file: a plain text list of media addresses. People also call it a playlist link when it's given to you as a web address rather than a file.
Is an M3U file a video file?
No. An M3U file is a plain text list of addresses. The video stays wherever those addresses point, and your player fetches it when you press play.
Can I open an M3U playlist on my TV without a player app?
Usually not. A TV's web browser will just download the file or show its text. You need a player app that can read M3U playlists.
Does an M3U playlist include the TV guide?
Usually not. The programme listings normally come from a separate guide address, and each channel's tvg-id label tells the player which listings belong to it.
Why do some channel names show strange symbols?
The playlist was probably saved with a different text encoding from the one your player expects. Playlists saved as UTF-8, which is required for .m3u8 files, display accented and non-Latin letters correctly.
