An IPTV M3U playlist is a plain-text list of channel names and stream addresses that your IPTV provider gives you as a file or a link. You load it into a player such as VLC, Kodi or an IPTV app, and the player turns it into a channel list you can browse.
Article summary
- What is an IPTV M3U playlist?
- M3U vs M3U8: what the file extension tells you
- Playlist file or playlist URL: which one your player wants
- How to load an M3U playlist in VLC, Kodi and IPTV apps
- VLC
- Kodi
- IPTV Smarters, TiviMate and similar apps
- Pairing your playlist with a TV guide (EPG)
- Why an M3U playlist won't load (and what to check)
- Is it safe to use free M3U playlists?
- Test your playlist in your own player before you commit
- More questions about IPTV M3U playlists
- Is an M3U playlist the same as an IPTV subscription?
- Why do some channels in my M3U playlist not work?
- Do M3U playlist links expire?
- Does an M3U playlist play on an Android box?
- How do I play an M3U file on Windows 10?
The rest of this guide shows what is inside the file, where it goes in each player, and what to check when it won’t open. If you are new to the whole idea, start with what IPTV is and how it works, then come back here.
What is an IPTV M3U playlist?
A playlist is not a subscription. The subscription is the service you pay for. The playlist is the format that service is delivered in: a short text file your player reads line by line.
Each channel takes two lines. The first describes the channel. The second is the address of its stream. Here is a made-up example with placeholder addresses:
#EXTM3U
#EXTINF:-1 tvg-id="channel-a" tvg-name="Channel A" tvg-logo="http://example.com/logo-a.png" group-title="News",Channel A
http://example.com/stream1.ts
#EXTINF:-1 tvg-id="channel-b" tvg-name="Channel B" tvg-logo="http://example.com/logo-b.png" group-title="Sports",Channel B
http://example.com/stream2.ts
The table below explains what each part of that example does.
| Line or attribute | What it does |
|---|---|
#EXTM3U |
Marks the file as an extended M3U playlist. It must be the first line. |
#EXTINF:-1 ...,Channel A |
Gives a duration and the name shown in your player. |
tvg-id |
The key a player uses to match the channel to its TV guide entry. |
tvg-logo / group-title |
The channel logo and the category it sits under. These are informal IPTV extensions, not part of a formal standard. |
| Stream URL line | The address the player opens when you pick that channel. |
Sources: IETF, RFC 8216 HTTP Live Streaming, 2017 for the header rule; Wikipedia, M3U for #EXTINF and the IPTV attributes.
M3U started life as a music playlist format for the Winamp player. The tvg-id, tvg-logo and group-title attributes were added later by IPTV software, and players support them by convention rather than by any official rule. That is why two apps can show the same list a little differently.
Some providers also offer an Xtream Codes login (a server, username and password) as an alternative to a playlist link. If you are choosing between the two, our comparison of M3U vs Xtream Codes covers the trade-offs.
M3U vs M3U8: what the file extension tells you
The extra “8” stands for UTF-8, the text encoding. According to RFC 8216, HTTP Live Streaming playlists must be encoded in UTF-8. A server identifies them by a path ending in .m3u8 or .m3u, or by the content type application/vnd.apple.mpegurl or audio/mpegurl.
There is a second meaning worth knowing. In HTTP Live Streaming (HLS), an .m3u8 file is often a stream manifest, not a channel list. Apple’s overview of HTTP Live Streaming describes media playlists as M3U text files that list the short video segments of one stream. A master playlist sits above them and lists the quality versions of that stream.
So an .m3u8 link can point to one channel’s video pieces rather than to a list of channels. For live streams, RFC 8216 says the player reloads the playlist to discover new segments, which is why a live .m3u8 keeps changing.
The practical takeaway is simple. Most IPTV players accept both extensions, so enter exactly what your provider sent you and don’t rename it.
Playlist file or playlist URL: which one your player wants
Providers deliver a playlist in one of two ways:
- A playlist URL. A web address that returns the list. The provider can update it, so your channels stay current.
- A playlist file. A downloaded .m3u file saved on your device. It is a snapshot, so it goes stale when the provider changes anything.
Players keep these apart. Kodi’s PVR IPTV Simple Client asks for the playlist as either a local path (a file) or a remote path (a URL), and it can refresh the playlist automatically. Other players use labels like “file” and “URL” or “local” and “remote”. Pasting a link into a file field is one of the most common reasons a list refuses to load.
With PlayTVX, the details arrive by email. PlayTVX states that after checkout, credentials and setup instructions are sent to you by email, to use in a compatible third-party player. You can see how that works on the PlayTVX subscription plans page.
Treat your playlist link like a password. It often identifies your account, so anyone who has it may be able to use it. Keep it out of forums, screenshots and shared notes.
How to load an M3U playlist in VLC, Kodi and IPTV apps
The steps differ by player, but the idea is the same everywhere: find the place for a playlist, choose file or URL, paste or browse, and wait for the channels to appear.
VLC
The VideoLAN documentation on opening media puts network addresses in the Open Network Stream dialog.
- Open VLC and go to Media > Open Network Stream.
- Paste your playlist URL and press Play.
- If playback stutters, open Show more options and raise the Caching value before you play.
For a downloaded file, open it with VLC like any other media file. For a full desktop walkthrough, see our guide to setting up IPTV on Windows or Mac.
Kodi
Kodi reads an IPTV M3U playlist through an official add-on, the PVR IPTV Simple Client.
- Go to Settings > Add-ons > Install from repository > PVR clients > PVR IPTV Simple Client and install it.
- Open the add-on’s settings and set the M3U location to local path or remote path.
- Enter the file or the URL, and add the XMLTV guide if your provider gave you one.
Since Kodi 20 (Nexus), the Kodi wiki page for the add-on notes that you can add more than one M3U and XMLTV pair.
IPTV Smarters, TiviMate and similar apps
To add an M3U playlist to IPTV Smarters Pro, look for the option to add a playlist by URL or by file. Give it a name, paste your link, and wait while the app loads the channel list. Menu names change between app versions, so follow the labels on your screen. Our step-by-step guides cover IPTV Smarters Pro on Firestick and the TiviMate setup guide.
These apps are independent products from their own developers. Install them only from your device’s official app store, never from a download link or a modified copy.
Pairing your playlist with a TV guide (EPG)
The playlist carries the channels. The TV guide, or EPG (electronic program guide), is a separate file in XMLTV format, usually delivered as its own URL.
Your player joins the two. Kodi’s PVR IPTV Simple Client matches each playlist entry’s tvg-id to a channel id in the XMLTV guide, and falls back to tvg-name when there is no tvg-id match. It can refresh both the playlist and the guide automatically.
That matching explains most empty guides:
- No guide URL was added to the player.
- The playlist’s
tvg-iddoesn’t match any channel id in the guide. - The guide hasn’t finished loading yet.
If the guide is still blank after you check those, our article on IPTV EPG not working goes through the fixes in detail.
Why an M3U playlist won't load (and what to check)
Start by asking one question: does the whole list fail, or only one channel? If the whole list fails, the problem is the link or the field you put it in. If the list loads but one channel won’t play, the problem is that single stream.
When the whole list fails, check these in order:
- A typo or a cut-off URL. Copy the link again from the original email instead of retyping it.
- The wrong field. A URL in a file field, or a file path in a URL field, fails every time.
- A link that returns a web page. Open the link in a browser. A working playlist starts with
#EXTM3Uon the first line. A login page or an error page means the link is wrong or no longer active. - A stale file or a changed link. If a list that used to work stops loading, ask your provider for the current link.
- A file broken by editing. If you edited the file, save it as UTF-8 text, the encoding playlists require.
The table sums up what you are likely to see and what to try first.
| What you see | Likely cause | What to try |
|---|---|---|
| The whole list fails with an error | Wrong field or a typo in the URL | Re-paste the link into the URL field |
| The link opens a login or web page | Wrong or expired link, so line one is not #EXTM3U |
Ask your provider for the current link |
| Channels load but the guide is empty | No XMLTV guide added, or a tvg-id mismatch | Add the guide URL and wait for it to load |
| One channel fails | That stream is down | Report the channel to your provider |
| Streams stutter after loading | Bandwidth or buffer size | Raise caching in VLC and test your speed |
Sources: IETF, RFC 8216 for the #EXTM3U first-line rule; VideoLAN wiki, Open Media for the caching setting.
Stutter after a list loads is a speed problem, not a playlist problem. PlayTVX advises at least 15 Mbps for HD and 25 Mbps or more for 4K. Our guide to internet speed for IPTV explains how to test yours, and you can fix IPTV buffering with the steps in that article.
Is it safe to use free M3U playlists?
No. Load only the playlist your own subscription gives you, and stay away from “free M3U” list sites and unknown streaming apps.
The FTC consumer alert from May 2019 warns that if you download an illegal pirate app or add-on, the chances are good you will also download malware. That malware can try to infect other devices on your home network. The FTC’s advice is direct: don’t watch pirated content.
A link that plays tells you nothing about whether the content is licensed. Before you subscribe anywhere, check that the provider has the rights to what it offers, and check the law where you live.
Keep your own link private too. PlayTVX’s terms prohibit account sharing, and a link posted publicly can be used by strangers on your account.
Test your playlist in your own player before you commit
Three things matter most with an IPTV M3U playlist. The file is just a list of channels and addresses. It has to go into the right field, URL or file. And it needs a matching XMLTV guide to fill the program grid.
The best test is your own setup: the player you like, on the TV or device you will actually watch on. PlayTVX states that credentials and setup instructions arrive by email after checkout, ready to paste into the player you already use.
Try your IPTV M3U playlist in your own player with the 24-hour trial for $1.99 before choosing a plan.
More questions about IPTV M3U playlists
Is an M3U playlist the same as an IPTV subscription?
No. An M3U playlist is the delivery format, a text list of channel names and stream addresses. The IPTV subscription is the service those addresses point to, and the playlist only works while that service is active.
Why do some channels in my M3U playlist not work?
When an M3U playlist loads but some channels won’t play, the playlist itself is fine and those individual streams are the problem. Reloading the whole list rarely helps. Note the channel names and report them to your provider.
Do M3U playlist links expire?
An M3U playlist link can stop working when your subscription ends or when the provider changes the link. If a link that used to work suddenly returns an error or a web page, ask your provider for the current one rather than searching for a replacement online.
Does an M3U playlist play on an Android box?
Yes. An Android box can play an M3U playlist in any compatible IPTV player app installed from the official app store. Add the playlist by URL in the app’s settings, as described above, and see our IPTV Smarters Pro on Firestick guide for a worked example on a streaming stick.
How do I play an M3U file on Windows 10?
On Windows 10, open the M3U file in a desktop player such as VLC with Media > Open File, or use Media > Open Network Stream for a playlist link. The VideoLAN documentation covers both dialogs, and our Windows and Mac setup guide walks through the rest.
