M3U playlists explained

What is an M3U file?

M3U started as a simple playlist format for audio files: a text file with one media location per line. An extended version adds a header line (#EXTM3U) and an information line (#EXTINF) before each entry, describing its title and duration. The same extended M3U format is used by HTTP Live Streaming (HLS), standardized by the IETF in RFC 8216, and it's one of the outputs an IPTV encoder can produce.

IPTV playlists use extended M3U to list channels. Each entry typically includes:

• the channel name shown in your app
• a channel ID (tvg-id) that links it to the program guide
• a logo URL (tvg-logo)
• a group or category (group-title), such as News or Sports
• the stream address the app plays

M3U URL vs M3U file

Most IPTV providers give you an M3U URL rather than a file. The app fetches the playlist from that link, so channel changes made by the provider appear automatically when the app refreshes. A downloaded M3U file is a snapshot that won't update until you replace it — so use the URL whenever possible.

How to add an M3U playlist to a player app

1. Open your IPTV player app and look for Add playlist, Add user or M3U URL.
2. Give the playlist a name you'll recognize.
3. Paste the full M3U URL exactly as provided. It usually contains your username and password, so a single wrong character will stop it working.
4. If the app asks for an EPG (XMLTV) URL, add the guide link your provider gives you. See IPTV EPG explained.
5. Save and wait for the channels to load. Large playlists can take a minute.

For device-specific steps, see the IPTV installation guide.

M3U vs Xtream Codes: which should you use?

If your app supports both, Xtream Codes is usually more convenient. Our Xtream Codes login guide explains it.

What's inside a channel entry?

Each channel in an IPTV playlist is usually two lines: an information line beginning with #EXTINF, then the stream address. The information line carries attributes your player app reads:

You rarely need to touch these yourself, but knowing them explains common symptoms: a missing logo usually means a broken tvg-logo link, and a channel with no guide usually has a tvg-id that doesn't match the guide data.

Organizing a large playlist

• Hide the groups you never watch inside your player app rather than editing the file. Your changes survive playlist refreshes.
• Mark favorites so your most-watched channels sit at the top.
• Avoid downloading the playlist and editing it by hand: the next update from your provider won't reach a saved copy.
• If loading is slow on an older stick, a player app with group filtering helps more than a faster connection.

M3U, M3U8 and XMLTV at a glance

If your provider offers both an M3U link and an Xtream Codes login, try Xtream Codes first in apps that support it: it's shorter to type on a remote and usually loads the guide automatically.

Common M3U problems

• "Invalid playlist" or nothing loads: check that you copied the whole URL, with no spaces or missing characters at the end.
• Channels appear but won't play: your subscription may have expired, or the app's player may not support the stream type — try another internal player.
• No logos or guide: the program guide is a separate feed — add the EPG URL if one is provided.
• Playlist is out of date: use the URL rather than a downloaded file, and refresh the playlist in the app.

Keep your M3U link private

Because an IPTV M3U URL usually contains your login, treat it like a password. Don't post it in forums or screenshots, and only paste it into apps from developers you trust. If you think it has been shared, ask your provider to reset your credentials. Our account security guide has more tips.