An M3U playlist is a plain-text file that lists stream URLs, one per channel, each with a name and often a logo and category. IPTV players read it to build your channel list. An .m3u8 file is the same format saved as UTF-8, which is what allows non-English channel names to display correctly.
What is inside an M3U file?
An M3U file is a list of pairs: one line of metadata describing a channel, followed by one line giving its stream address. Opening one in a text editor shows exactly this, and it is worth doing once because it makes every later problem easier to diagnose.
#EXTM3U
#EXTINF:-1 tvg-id="bbc.one.uk" tvg-logo="https://example.com/bbc1.png" group-title="UK",BBC One
http://provider.example.com:8080/live/user/pass/1234.ts| Attribute | What it does | Matters when |
|---|---|---|
#EXTM3U | Marks the file as a playlist. Must be the first line | Its absence causes “could not be parsed” |
tvg-id | Links the channel to its guide entry | Your guide is empty or misaligned |
tvg-logo | URL of the channel icon | Logos are missing |
group-title | The category the channel appears under | Everything lands in one giant list |
| The URL line | Where the stream is actually fetched from | A single channel fails but others work |
M3U or M3U8 — is there a difference?
For a channel list, the only difference is text encoding: .m3u8 is UTF-8, so Arabic, Cyrillic and accented channel names survive. Confusingly, .m3u8 also names a completely different thing — the manifest inside an HLS stream — but that is internal to playback and not something you paste into a player.
Where do you get an M3U URL?
From us, by email, as soon as your line is activated. It usually contains your username and password in the address itself, which has one important consequence: anyone you send that URL to can use your subscription. Treat it as a password.
Why “playlist could not be parsed” happens
Almost always because the URL returned something that is not a playlist. The fastest test is to open the same URL in a desktop browser.
- A login or error page appears — the subscription has expired, or the credentials are wrong.
- Nothing downloads — the provider’s server is unreachable, or your network is blocking the port.
- A file downloads but is tiny — you are probably over your connection limit; many providers return an error stub rather than a proper message.
- The file looks right — check the very first line is
#EXTM3U. A stray blank line or byte-order mark before it will fail every parser.
Should you use M3U or Xtream Codes?
If your provider offers both, Xtream Codes is generally the better choice because it loads a category at a time rather than parsing the whole list. Our Xtream Codes guide explains the difference, and it matters most on memory-limited devices like a Firestick or a Smart TV.
Frequently asked questions
Can I edit an M3U file myself?
Yes, in any plain-text editor. People commonly trim a large list down to the channels they watch. Save it as UTF-8 without a byte-order mark, keep #EXTM3U as the first line, and load it as a local file.
Is it safe to share my M3U URL?
No. It normally embeds your username and password, so sharing it hands over your subscription. If you have posted one publicly, ask your provider to reissue your credentials.
Why do some channels have no logo?
The playlist has no tvg-logo for them, or the logo URL is dead. That is a property of the file your provider generates, not of the player.
How large can an M3U file get?
Large providers routinely produce files with tens of thousands of entries running to several megabytes. Anything above roughly 20,000 channels starts to strain low-memory devices, which is the point at which Xtream Codes becomes worth switching to.
Does IPTV Pro give me an M3U playlist?
Yes. When your line is activated we email you an M3U URL, and usually Xtream Codes details as well. Both point at the same subscription — use whichever your player prefers.