What is an M3U playlist?
An M3U playlist is a plain-text file that lists media entries and their URLs, one after another. In IPTV it’s the standard way a provider hands over a channel line-up: each entry names a channel and points at its stream, usually delivered as an .m3u or .m3u8 link.
How an M3U playlist works
The format is old and deliberately simple — it started as a list of MP3 file paths, and IPTV adopted it because a channel line-up is the same shape: names plus URLs. A file starts with an #EXTM3U header, then repeats one pattern per channel: an #EXTINF line carrying the channel name and tags — a guide id (tvg-id), a group name, a logo — followed by the stream URL itself.
The .m3u8 variant is the same format saved as UTF-8, so channel names in any alphabet survive. Confusingly, HLS streaming uses the same extension for its segment playlists — same syntax, different job. An IPTV provider’s M3U is a channel list, not a stream.
The tags carry more than a name: group-title sorts channels into categories, tvg-logo points at channel artwork, and catch-up tags advertise replay where the provider offers it. A player is free to ignore what it doesn’t understand — much of why the format has survived. The worst case for an unknown tag is a channel without a logo, not a broken list.
Providers usually serve the playlist from a URL rather than a file, so a player can re-fetch it and pick up line-up changes. That URL very often carries your account credentials inside it — treat an M3U link like a password, because for most providers it is one.
M3U vs Xtream Codes
The other common hand-over is an Xtream Codes login: a server address, username, and password instead of a single link. An M3U is one flat file you fetch whole; the Xtream API serves the same line-up in queryable pieces — categories, channels, guide data — as the player asks for them. Many providers offer both. If you were given a bare URL, you have an M3U; if you were given three fields, you have Xtream.
In Twiga
An M3U link is one of the two ways to add your provider. Paste it once and Twiga ingests the channels, sealing each channel URL with a key only you hold — what sits in our database is ciphertext. Playlist refreshes go out via Twiga’s VPN exits, and the TV guide fetch goes over Tor — your home IP appears in neither.
Got an M3U link from your provider? Add it to Twiga