How to Use Live TV M3U Playlists for Streaming

An M3U playlist is a text list of media locations. For live TV, each entry can name a channel and point a compatible player to its stream. The playlist itself does not grant access to a channel: use a playlist supplied by a broadcaster, service, or provider you are authorized to watch.

What you need before you start

• A working, authorized M3U URL or local .m3u file from your content provider.
• A stable internet connection and a player that accepts M3U playlists, such as Kodi with IPTV Simple Client.
• Optional: an XMLTV program-guide URL if your provider offers one.

Open an M3U playlist in Kodi

1. Install Kodi from its official source. In Kodi, go to Add-ons → My add-ons → PVR clients and install IPTV Simple Client from the official Kodi repository.
2. Open the add-on’s settings. Under General, choose a remote URL or local path and enter your authorized M3U source.
3. If you have a program guide, configure its XMLTV URL or file under EPG. Save the settings and enable the add-on.
4. Restart Kodi if prompted, then open TV → Channels. Channel availability depends on your provider and the playlist’s current links.

For screenshots and version-specific settings, see the official Kodi IPTV Simple Client guide and our Kodi IPTV setup walkthrough.

What is the difference between M3U and M3U8?

Both are playlist formats. M3U8 commonly means UTF-8 encoded playlist text and is also used for HTTP Live Streaming (HLS) manifests. An HLS .m3u8 file can point to video segments or alternate stream qualities; a channel-list M3U instead commonly lists multiple channel streams. The file extension alone does not tell you whether a source is licensed or safe. See the HLS specification for the technical format.

Fix common playback problems

The channel list is empty

Check whether you chose the correct URL/file setting, entered the complete address, and enabled the PVR client. If the provider uses a token, confirm that it has not expired. Try the source on the same device in another compatible player.

Channels appear but do not play

Test your connection and another channel. A stream may be offline, region-restricted, or unsupported by your device. Ask the legitimate provider for a current playlist rather than repeatedly downloading unverified lists.

The program guide is blank or mismatched

An M3U playlist and an XMLTV guide are separate inputs. Confirm the XMLTV source works and that its channel IDs match the playlist’s IDs. Kodi documents how tvg-id helps map channels to guide entries.

Using VLC for a quick stream check

VLC can open a network stream through Media → Open Network Stream. Paste an authorized stream URL to see whether the stream plays outside Kodi. This helps distinguish a source issue from a Kodi configuration issue. See VideoLAN’s desktop instructions.

Safety and legality

Do not assume a “free IPTV” list is licensed. Publicly posted links can disappear, redirect, or expose your device to unwanted sites. Prefer broadcaster-provided streams and legitimate subscriptions; avoid sharing account tokens or downloading unknown player APKs. For safer viewing ideas, read our legal live TV options guide.

Frequently asked questions

Does an M3U file contain the video?

No. It normally contains addresses and metadata for streams; playback still depends on reachable sources.

Do I need XMLTV?

No. It is optional guide data. Channels may play without it, but schedules may be missing.

Can I use an M3U playlist on more than one device?

That depends on the provider’s terms and allowed simultaneous connections. Check those terms before using the same source elsewhere.