M3U IPTV Playlists: What's Inside and How to Use One
Quick Answer
An M3U playlist is a plain-text file listing streams: each channel has an #EXTINF line with its name, logo, group and guide ID, followed by the stream address. IPTV services usually give you a link to the file rather than the file itself, so the list stays up to date. Paste the link into a player app's M3U or playlist option, and the app builds the channel list from it.
Key Points
- Plain text: a header line, then pairs of info lines and stream addresses.
- group-title sets categories; tvg-id links a channel to guide data.
- M3U8 is the UTF-8 version; HLS streams also use .m3u8 files.
- A link stays current; a downloaded file is a snapshot.
- Keep your link private: it usually contains your login.
M3U is the oldest and most widely supported IPTV playlist format. Almost every player accepts it, which is why services offer it alongside Xtream Codes logins.
What's Inside the File
A playlist starts with #EXTM3U. Each channel then has an information line and an address line. A typical information line reads: #EXTINF:-1 tvg-id="channel.id" tvg-name="Channel Name" tvg-logo="logo address" group-title="News",Channel Name.
| Attribute | What it does |
|---|---|
| tvg-id | Matches the channel to programme guide (XMLTV) data |
| tvg-name | The channel name used for matching and display |
| tvg-logo | Address of the channel logo |
| group-title | The category the app shows the channel in |
M3U vs M3U8
M3U8 is the same format saved as UTF-8 text, so channel names with accents and non-Latin characters display correctly. Separately, HLS streaming uses .m3u8 files to list video segments; that is the same text format put to a different job. For your purposes, a player that accepts M3U accepts M3U8.
Adding a Playlist Link
- Find the M3U or playlist option in your app (in IPTV Smarters Pro: Load Your Playlist or File/URL; in TiviMate: Add playlist > M3U playlist).
- Paste the full link and give the playlist a name.
- Add the EPG (XMLTV) address if the app asks and your provider supplies one.
- Wait for channels to load; large lists can take a minute the first time.
If a Playlist Won't Load
- Check the link is complete: links often end with username and password parameters, and a partial copy breaks them.
- Open the link in VLC on a computer (how to). If it fails there too, the link or account is the problem, not the app.
- Check the subscription is active and not over its connection limit.
- For very large lists, try an app that handles big playlists well, such as TiviMate.
Keep Your Link Private
An M3U link from a paid service normally contains your username and password. Anyone with it can use your connections. Don't post it in forums when asking for help, and be cautious with shared public playlists, covered in our free IPTV guide.
Frequently Asked Questions
Should I use M3U or Xtream Codes?
Use Xtream Codes where the app supports it; it loads on-demand content and the guide more completely. Use M3U for apps that only accept playlists.
Can I edit an M3U file?
Yes, in any text editor, but edits are lost when the provider's list updates. Most apps let you hide groups instead.
Where to put the link for Xtreme HD IPTV is shown in the setup guide.