IPTV formats explained: M3U, XMLTV, Xtream, Stalker, HLS
This reference describes the formats an IPTV player reads: M3U and M3U8 playlists, XMLTV guides, the Xtream Codes API, Stalker portals, and HLS versus MPEG-TS streams. Each section has a short table of what the format contains. CodoPlayer reads what your provider supplies and adds no content.
By the CodoPlayer team. Last updated . CodoPlayer provides no channels, films, series, playlists or subscriptions. You bring your own source and you are responsible for using it lawfully.
What is an M3U or M3U8 playlist?
An M3U or M3U8 playlist is a text file or link that lists streams, one per entry, usually with a name, a group and a logo. M3U8 is the same layout saved as UTF-8. CodoPlayer reads both, builds channels and groups from the entries, and plays the stream addresses.
| Part of the file | What it holds | What the CodoPlayer web player does with it |
|---|---|---|
| #EXTM3U | The first line. Some playlists add a guide link here (url-tvg or x-tvg-url). | It reads url-tvg, x-tvg-url or tvg-url as the guide link, but the web player loads no XMLTV guide for an M3U playlist. |
| #EXTINF | Starts an entry: a duration (usually -1 for live), attributes, and the display name after a comma. | It reads attributes written in single or double quotes. The name is the text after the first comma that is outside quotes. |
| tvg-id | The id that links the channel to a channel in the TV guide. | It keeps the id with the channel. With no guide loaded for an M3U playlist, the web player shows no programmes from it. |
| tvg-name | A name used when matching the guide. | It uses it as the channel name only when there is no name after the comma. |
| tvg-logo | The address of the channel logo. | It reads it as the logo address. |
| group-title | The group or category the channel is listed in. | It reads it as the group. An entry without one goes into a group called General. |
| Stream line | The line after #EXTINF: the address of the stream. | Any line that does not start with # is taken as an address. An address containing /movie/ is a film, one containing /series/ is a series episode, and anything else is a live channel. A link with no #EXTINF line of its own takes nothing from the entry before it. |
These attributes are conventions, not a formal standard. A player reads the ones it finds. The right-hand column describes the web player only; the apps are not covered by it.
See also: M3U player, M3U Validator, Playlist Compare, M3U Playlist Creator, Hide channel groups per profile on Android TV.
What is the XMLTV format?
XMLTV is an XML file format for TV guide data. Channels are declared once with an id, and each programme names its channel, start and stop times, a title and often a description. A player matches the channel id to the tvg-id in your playlist, which is why mismatched ids show "No information".
| Element or value | Meaning | What the XMLTV Viewer tool does with it (in your browser) |
|---|---|---|
| tv | The root element of the file. | A file is accepted if the tag tv appears in its first 5,000 characters or it holds a programme element; otherwise it is refused as not XMLTV. Plain or gzip, up to 80 MB after unpacking. |
| channel id="…" | Declares a channel. The id is what playlists refer to. | It reads the id. |
| display-name | A readable channel name inside a channel element. | It reads the first display-name of each channel. |
| programme | One programme, with start, stop and channel attributes. | It reads start, stop and channel. A programme whose start it cannot read is skipped; a missing or unreadable stop is treated as the start. |
| title, desc | The programme title and description. | It reads the first title. It does not list the description; its XMLTV export copies each programme element as it was. |
| start / stop | Times as YYYYMMDDHHMMSS followed by a UTC offset, for example 20261112180000 +0000. | It accepts the date with or without hours, minutes and seconds, and an offset with or without a colon. A time with no offset is read as UTC. |
Wrong times in a guide are usually a wrong offset, which the EPG Time Shifter can correct. The web player does not read an XMLTV file for an M3U playlist; the right-hand column describes the XMLTV Viewer tool.
See also: IPTV EPG and TV guide, XMLTV Viewer, Guide times wrong.
Public specification: the XMLTV format (XMLTV project wiki).
What is the Xtream Codes API?
The Xtream Codes API is a set of web addresses on the provider's server, used with a username and password. One address returns account details, others return lists of live channels, films and series, and another returns the TV guide. A player that speaks the API needs only the server address and the login.
| Address on the provider server | What it returns |
|---|---|
| player_api.php?username=…&password=… | Account information, including the state and the expiry date. |
| … &action=get_live_streams | The live channels (get_live_categories lists the categories). |
| … &action=get_vod_streams | The films. |
| … &action=get_series | The series. |
| get.php?username=…&password=…&type=m3u_plus | The same account as an M3U playlist. |
| xmltv.php?username=…&password=… | The TV guide as an XMLTV file. |
Providers implement this API themselves, so details can differ from one provider to another.
See also: Xtream Codes player, M3U or Xtream Codes, Find an Xtream login in an M3U link, Bring your playlist to CodoPlayer.
What is a Stalker or Ministra portal?
A Stalker (Ministra) portal is a provider system that identifies a device by its MAC address instead of a username and password. You enter the portal address and the MAC your provider registered, and the app asks the portal for channels. CodoPlayer supports portals in its Android and Android TV apps.
| Item | Meaning |
|---|---|
| Portal address | The web address of the provider portal. |
| MAC address | The identifier your provider registered for you. |
| Stream links | They only work while they play, so a portal’s films cannot be downloaded for offline viewing. |
There is no Stalker support in the Windows, Linux or web player.
See also: Stalker portal player.
What is the difference between HLS and MPEG-TS streams?
HLS delivers video as a playlist of short segments, usually an .m3u8 address, while MPEG-TS is one continuous stream, often ending in .ts. Browsers play HLS far more readily than raw MPEG-TS, and many Xtream lines offer both. If one form fails, the other may work.
| HLS (.m3u8) | MPEG-TS (.ts) | |
|---|---|---|
| Delivery | A playlist of short segments | One continuous stream |
| In a browser | Safari plays it itself; other browsers need a script | Not played by browsers on their own |
| On Xtream lines | Output type m3u8 | Output type ts |
HLS is specified in RFC 8216.
See also: M3U player, M3U8 Player and HLS Inspector, Streams blocked in the browser.
Public specification: RFC 8216, HTTP Live Streaming.
Which video and sound formats can my browser play?
It depends on the browser, its version and the device. The Browser Playback Test asks your own browser the questions below and shows its answer for each format. Nothing is sent to us. It is the browser's answer, not a test with one of your channels.
| Format | What the test asks your browser | Group |
|---|---|---|
| H.264 (AVC) | MediaSource.isTypeSupported with video/mp4; codecs="avc1.640028" | Picture (video codecs) |
| HEVC (H.265) | MediaSource.isTypeSupported with video/mp4; codecs="hvc1.1.6.L123.B0" | Picture (video codecs) |
| AV1 | MediaSource.isTypeSupported with video/mp4; codecs="av01.0.08M.08" | Picture (video codecs) |
| VP9 | MediaSource.isTypeSupported with video/webm; codecs="vp09.00.10.08" | Picture (video codecs) |
| AAC | MediaSource.isTypeSupported with audio/mp4; codecs="mp4a.40.2" | Sound (audio codecs) |
| AC-3 (Dolby Digital) | MediaSource.isTypeSupported with audio/mp4; codecs="ac-3" | Sound (audio codecs) |
| E-AC-3 (Dolby Digital Plus) | MediaSource.isTypeSupported with audio/mp4; codecs="ec-3" | Sound (audio codecs) |
| Opus | MediaSource.isTypeSupported with audio/webm; codecs="opus" | Sound (audio codecs) |
| FLAC | MediaSource.isTypeSupported with audio/mp4; codecs="flac" | Sound (audio codecs) |
| Native HLS | canPlayType on a video element with application/vnd.apple.mpegurl | Stream formats and browser features |
| Media Source Extensions | Whether the browser has this feature (probe name: mse) | Stream formats and browser features |
| MPEG-TS through Media Source | MediaSource.isTypeSupported with video/mp2t; codecs="avc1.640028, mp4a.40.2" | Stream formats and browser features |
| Fragmented MP4 (fMP4) | MediaSource.isTypeSupported with video/mp4; codecs="avc1.640028, mp4a.40.2" | Stream formats and browser features |
MPEG-TS and the other stream formats are explained in the HLS and MPEG-TS section above. A format the browser cannot decode may play with another browser or in a CodoPlayer app.
See also: Browser Playback Test, Streams blocked in the browser, Error messages.
What the CodoPlayer web player plays in your browser (measured)
Chrome: 175 of 176 played fully. Firefox: 174 of 176 played fully. A case can appear in several groups. Your browser decodes the clips using its own decoder or the web player’s code on the page.
| Group | Chrome | Firefox | Note |
|---|---|---|---|
| Picture: H.264 | 89 of 90 played fully | 89 of 90 played fully | Chrome and Firefox: H.264 Main + AAC / MP4 (Film blocked by the source) — not played: the source server did not let the browser read the clip, and the player said so. |
| Picture: HEVC | 10 of 10 played fully | 9 of 10 played fully | Firefox: HEVC Main 10 4K + AAC / TS (Live HLS) — played in part. |
| Picture: MPEG-2 | 13 of 13 played fully | 13 of 13 played fully | |
| Picture: MPEG-1 | 1 of 1 played fully | 1 of 1 played fully | |
| Picture: MPEG-4 Part 2 | 3 of 3 played fully | 3 of 3 played fully | |
| Picture: H.263 | 2 of 2 played fully | 2 of 2 played fully | |
| Picture: Sorenson Spark | 1 of 1 played fully | 1 of 1 played fully | |
| Picture: DivX 3 | 1 of 1 played fully | 1 of 1 played fully | |
| Picture: VP8 | 1 of 1 played fully | 1 of 1 played fully | |
| Picture: VP9 | 4 of 4 played fully | 4 of 4 played fully | |
| Picture: AV1 | 2 of 2 played fully | 2 of 2 played fully | |
| Picture: WMV 7 | 1 of 1 played fully | 1 of 1 played fully | |
| Picture: WMV 8 | 1 of 1 played fully | 1 of 1 played fully | |
| Picture: Motion JPEG | 1 of 1 played fully | 1 of 1 played fully | |
| Picture: RealVideo 2 | 1 of 1 played fully | 1 of 1 played fully | |
| Picture: ProRes | 1 of 1 played fully | 1 of 1 played fully | |
| Picture: DNxHD | 1 of 1 played fully | 1 of 1 played fully | |
| Picture: DV | 1 of 1 played fully | 1 of 1 played fully | |
| Picture: Cinepak | 1 of 1 played fully | 1 of 1 played fully | |
| Picture: FFV1 | 1 of 1 played fully | 1 of 1 played fully | |
| Picture: HuffYUV | 1 of 1 played fully | 1 of 1 played fully | |
| Picture: FFVHuff | 1 of 1 played fully | 1 of 1 played fully | |
| Picture: QuickTime Animation | 4 of 4 played fully | 4 of 4 played fully | |
| Picture: VC-1 | 4 of 4 played fully | 4 of 4 played fully | |
| Picture: Theora | 1 of 1 played fully | 1 of 1 played fully | |
| Sound: AAC | 55 of 56 played fully | 54 of 56 played fully | Chrome: H.264 Main + AAC / MP4 (Film blocked by the source) — not played: the source server did not let the browser read the clip, and the player said so. Firefox: HEVC Main 10 4K + AAC / TS (Live HLS) — played in part. Firefox: H.264 Main + AAC / MP4 (Film blocked by the source) — not played: the source server did not let the browser read the clip, and the player said so. |
| Sound: MP2 | 25 of 25 played fully | 25 of 25 played fully | |
| Sound: MP3 | 7 of 7 played fully | 7 of 7 played fully | |
| Sound: Vorbis | 4 of 4 played fully | 4 of 4 played fully | |
| Sound: Opus | 8 of 8 played fully | 8 of 8 played fully | |
| Sound: WMA 1 | 1 of 1 played fully | 1 of 1 played fully | |
| Sound: WMA 2 | 3 of 3 played fully | 3 of 3 played fully | |
| Sound: PCM | 18 of 18 played fully | 18 of 18 played fully | |
| Sound: AC-3 | 20 of 20 played fully | 20 of 20 played fully | |
| Sound: FLAC | 4 of 4 played fully | 4 of 4 played fully | |
| Sound: WMA 9 Pro | 1 of 1 played fully | 1 of 1 played fully | |
| Sound: AAC-LC | 1 of 1 played fully | 1 of 1 played fully | |
| Sound: HE-AAC v1 | 5 of 5 played fully | 5 of 5 played fully | |
| Sound: MP1 | 4 of 4 played fully | 4 of 4 played fully | |
| Sound: E-AC-3 | 6 of 6 played fully | 6 of 6 played fully | |
| Sound: DTS | 3 of 3 played fully | 3 of 3 played fully | |
| Sound: Dolby TrueHD | 3 of 3 played fully | 3 of 3 played fully | |
| Sound: ALAC | 2 of 2 played fully | 2 of 2 played fully | |
| Sound: G.711 mu-law | 2 of 2 played fully | 2 of 2 played fully | |
| Sound: G.711 A-law | 1 of 1 played fully | 1 of 1 played fully | |
| Sound: DVD LPCM | 1 of 1 played fully | 1 of 1 played fully | |
| Sound: AMR-NB | 2 of 2 played fully | 2 of 2 played fully | |
| Sound: AMR-WB | 2 of 2 played fully | 2 of 2 played fully | |
| File type: MP4 | 17 of 18 played fully | 17 of 18 played fully | Chrome and Firefox: H.264 Main + AAC / MP4 (Film blocked by the source) — not played: the source server did not let the browser read the clip, and the player said so. |
| File type: MKV | 30 of 30 played fully | 30 of 30 played fully | |
| File type: TS | 60 of 60 played fully | 59 of 60 played fully | Firefox: HEVC Main 10 4K + AAC / TS (Live HLS) — played in part. |
| File type: MPG | 2 of 2 played fully | 2 of 2 played fully | |
| File type: AVI | 7 of 7 played fully | 7 of 7 played fully | |
| File type: 3GP | 4 of 4 played fully | 4 of 4 played fully | |
| File type: FLV | 2 of 2 played fully | 2 of 2 played fully | |
| File type: WebM | 4 of 4 played fully | 4 of 4 played fully | |
| File type: ASF | 1 of 1 played fully | 1 of 1 played fully | |
| File type: WMV | 3 of 3 played fully | 3 of 3 played fully | |
| File type: RM | 1 of 1 played fully | 1 of 1 played fully | |
| File type: MOV | 12 of 12 played fully | 12 of 12 played fully | |
| File type: M2TS | 6 of 6 played fully | 6 of 6 played fully | |
| File type: ADTS | 2 of 2 played fully | 2 of 2 played fully | |
| File type: .mp1 | 1 of 1 played fully | 1 of 1 played fully | |
| File type: .thd | 1 of 1 played fully | 1 of 1 played fully | |
| File type: VOB | 3 of 3 played fully | 3 of 3 played fully | |
| File type: .amr | 1 of 1 played fully | 1 of 1 played fully | |
| File type: .awb | 1 of 1 played fully | 1 of 1 played fully | |
| File type: WMA | 1 of 1 played fully | 1 of 1 played fully | |
| File type: Ogg | 3 of 3 played fully | 3 of 3 played fully | |
| File type: .mp3 | 1 of 1 played fully | 1 of 1 played fully | |
| File type: .mp2 | 1 of 1 played fully | 1 of 1 played fully | |
| File type: .ac3 | 1 of 1 played fully | 1 of 1 played fully | |
| File type: .eac3 | 1 of 1 played fully | 1 of 1 played fully | |
| File type: .dts | 1 of 1 played fully | 1 of 1 played fully | |
| File type: .flac | 1 of 1 played fully | 1 of 1 played fully | |
| File type: WAV | 2 of 2 played fully | 2 of 2 played fully | |
| File type: AIFF | 1 of 1 played fully | 1 of 1 played fully | |
| File type: AU | 1 of 1 played fully | 1 of 1 played fully | |
| File type: M4A | 2 of 2 played fully | 2 of 2 played fully | |
| File type: MKA | 1 of 1 played fully | 1 of 1 played fully | |
| Subtitles: SRT | 3 of 3 played fully | 3 of 3 played fully | |
| Subtitles: ASS | 4 of 4 played fully | 4 of 4 played fully | |
| Subtitles: WebVTT | 4 of 4 played fully | 4 of 4 played fully | |
| Subtitles: mov_text | 1 of 1 played fully | 1 of 1 played fully | |
| Subtitles: TTML | 1 of 1 played fully | 1 of 1 played fully | |
| Subtitles: PGS | 2 of 2 played fully | 2 of 2 played fully | |
| Subtitles: DVB subtitles | 6 of 6 played fully | 6 of 6 played fully | |
| Subtitles: DVD subtitles | 1 of 1 played fully | 1 of 1 played fully | |
| Subtitles: VobSub | 1 of 1 played fully | 1 of 1 played fully | |
| Subtitles: DVB teletext subtitles | 3 of 3 played fully | 3 of 3 played fully | |
| Subtitles: CEA-608 captions | 4 of 4 played fully | 4 of 4 played fully | |
| Delivery: Film | 135 of 136 played fully | 135 of 136 played fully | Chrome and Firefox: H.264 Main + AAC / MP4 (Film blocked by the source) — not played: the source server did not let the browser read the clip, and the player said so. |
| Delivery: Live TS | 20 of 20 played fully | 20 of 20 played fully | |
| Delivery: Live HLS | 20 of 20 played fully | 19 of 20 played fully | Firefox: HEVC Main 10 4K + AAC / TS (Live HLS) — played in part. |
The tests used made-up clips as films and live streams in the web player. Measured on 2026-11-18 with Chrome 157.0.8103.79 and Firefox 151.0 on Windows 11. Safari was not measured. Decoding that depends on the device’s hardware (HEVC 10-bit 4K) can differ on another computer.
See also: Browser Playback Test, Streams blocked in the browser.
Terms
For short definitions of these and related terms, see the IPTV glossary and the error messages reference.