Skip to content
CodoPlayer

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.

What is an M3U or M3U8 playlist?
Part of the fileWhat it holdsWhat the CodoPlayer web player does with it
#EXTM3UThe 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.
#EXTINFStarts 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-idThe 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-nameA name used when matching the guide.It uses it as the channel name only when there is no name after the comma.
tvg-logoThe address of the channel logo.It reads it as the logo address.
group-titleThe 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 lineThe 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".

What is the XMLTV format?
Element or valueMeaningWhat the XMLTV Viewer tool does with it (in your browser)
tvThe 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-nameA readable channel name inside a channel element.It reads the first display-name of each channel.
programmeOne 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, descThe 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 / stopTimes 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.

What is the Xtream Codes API?
Address on the provider serverWhat it returns
player_api.php?username=…&password=…Account information, including the state and the expiry date.
… &action=get_live_streamsThe live channels (get_live_categories lists the categories).
… &action=get_vod_streamsThe films.
… &action=get_seriesThe series.
get.php?username=…&password=…&type=m3u_plusThe 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.

What is a Stalker or Ministra portal?
ItemMeaning
Portal addressThe web address of the provider portal.
MAC addressThe identifier your provider registered for you.
Stream linksThey 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.

What is the difference between HLS and MPEG-TS streams?
HLS (.m3u8)MPEG-TS (.ts)
DeliveryA playlist of short segmentsOne continuous stream
In a browserSafari plays it itself; other browsers need a scriptNot played by browsers on their own
On Xtream linesOutput type m3u8Output 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.

Which video and sound formats can my browser play?
FormatWhat the test asks your browserGroup
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)
AV1MediaSource.isTypeSupported with video/mp4; codecs="av01.0.08M.08"Picture (video codecs)
VP9MediaSource.isTypeSupported with video/webm; codecs="vp09.00.10.08"Picture (video codecs)
AACMediaSource.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)
OpusMediaSource.isTypeSupported with audio/webm; codecs="opus"Sound (audio codecs)
FLACMediaSource.isTypeSupported with audio/mp4; codecs="flac"Sound (audio codecs)
Native HLScanPlayType on a video element with application/vnd.apple.mpegurlStream formats and browser features
Media Source ExtensionsWhether the browser has this feature (probe name: mse)Stream formats and browser features
MPEG-TS through Media SourceMediaSource.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.

What the CodoPlayer web player plays in your browser (measured)
GroupChromeFirefoxNote
Picture: H.26489 of 90 played fully89 of 90 played fullyChrome 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: HEVC10 of 10 played fully9 of 10 played fullyFirefox: HEVC Main 10 4K + AAC / TS (Live HLS) — played in part.
Picture: MPEG-213 of 13 played fully13 of 13 played fully
Picture: MPEG-11 of 1 played fully1 of 1 played fully
Picture: MPEG-4 Part 23 of 3 played fully3 of 3 played fully
Picture: H.2632 of 2 played fully2 of 2 played fully
Picture: Sorenson Spark1 of 1 played fully1 of 1 played fully
Picture: DivX 31 of 1 played fully1 of 1 played fully
Picture: VP81 of 1 played fully1 of 1 played fully
Picture: VP94 of 4 played fully4 of 4 played fully
Picture: AV12 of 2 played fully2 of 2 played fully
Picture: WMV 71 of 1 played fully1 of 1 played fully
Picture: WMV 81 of 1 played fully1 of 1 played fully
Picture: Motion JPEG1 of 1 played fully1 of 1 played fully
Picture: RealVideo 21 of 1 played fully1 of 1 played fully
Picture: ProRes1 of 1 played fully1 of 1 played fully
Picture: DNxHD1 of 1 played fully1 of 1 played fully
Picture: DV1 of 1 played fully1 of 1 played fully
Picture: Cinepak1 of 1 played fully1 of 1 played fully
Picture: FFV11 of 1 played fully1 of 1 played fully
Picture: HuffYUV1 of 1 played fully1 of 1 played fully
Picture: FFVHuff1 of 1 played fully1 of 1 played fully
Picture: QuickTime Animation4 of 4 played fully4 of 4 played fully
Picture: VC-14 of 4 played fully4 of 4 played fully
Picture: Theora1 of 1 played fully1 of 1 played fully
Sound: AAC55 of 56 played fully54 of 56 played fullyChrome: 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: MP225 of 25 played fully25 of 25 played fully
Sound: MP37 of 7 played fully7 of 7 played fully
Sound: Vorbis4 of 4 played fully4 of 4 played fully
Sound: Opus8 of 8 played fully8 of 8 played fully
Sound: WMA 11 of 1 played fully1 of 1 played fully
Sound: WMA 23 of 3 played fully3 of 3 played fully
Sound: PCM18 of 18 played fully18 of 18 played fully
Sound: AC-320 of 20 played fully20 of 20 played fully
Sound: FLAC4 of 4 played fully4 of 4 played fully
Sound: WMA 9 Pro1 of 1 played fully1 of 1 played fully
Sound: AAC-LC1 of 1 played fully1 of 1 played fully
Sound: HE-AAC v15 of 5 played fully5 of 5 played fully
Sound: MP14 of 4 played fully4 of 4 played fully
Sound: E-AC-36 of 6 played fully6 of 6 played fully
Sound: DTS3 of 3 played fully3 of 3 played fully
Sound: Dolby TrueHD3 of 3 played fully3 of 3 played fully
Sound: ALAC2 of 2 played fully2 of 2 played fully
Sound: G.711 mu-law2 of 2 played fully2 of 2 played fully
Sound: G.711 A-law1 of 1 played fully1 of 1 played fully
Sound: DVD LPCM1 of 1 played fully1 of 1 played fully
Sound: AMR-NB2 of 2 played fully2 of 2 played fully
Sound: AMR-WB2 of 2 played fully2 of 2 played fully
File type: MP417 of 18 played fully17 of 18 played fullyChrome 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: MKV30 of 30 played fully30 of 30 played fully
File type: TS60 of 60 played fully59 of 60 played fullyFirefox: HEVC Main 10 4K + AAC / TS (Live HLS) — played in part.
File type: MPG2 of 2 played fully2 of 2 played fully
File type: AVI7 of 7 played fully7 of 7 played fully
File type: 3GP4 of 4 played fully4 of 4 played fully
File type: FLV2 of 2 played fully2 of 2 played fully
File type: WebM4 of 4 played fully4 of 4 played fully
File type: ASF1 of 1 played fully1 of 1 played fully
File type: WMV3 of 3 played fully3 of 3 played fully
File type: RM1 of 1 played fully1 of 1 played fully
File type: MOV12 of 12 played fully12 of 12 played fully
File type: M2TS6 of 6 played fully6 of 6 played fully
File type: ADTS2 of 2 played fully2 of 2 played fully
File type: .mp11 of 1 played fully1 of 1 played fully
File type: .thd1 of 1 played fully1 of 1 played fully
File type: VOB3 of 3 played fully3 of 3 played fully
File type: .amr1 of 1 played fully1 of 1 played fully
File type: .awb1 of 1 played fully1 of 1 played fully
File type: WMA1 of 1 played fully1 of 1 played fully
File type: Ogg3 of 3 played fully3 of 3 played fully
File type: .mp31 of 1 played fully1 of 1 played fully
File type: .mp21 of 1 played fully1 of 1 played fully
File type: .ac31 of 1 played fully1 of 1 played fully
File type: .eac31 of 1 played fully1 of 1 played fully
File type: .dts1 of 1 played fully1 of 1 played fully
File type: .flac1 of 1 played fully1 of 1 played fully
File type: WAV2 of 2 played fully2 of 2 played fully
File type: AIFF1 of 1 played fully1 of 1 played fully
File type: AU1 of 1 played fully1 of 1 played fully
File type: M4A2 of 2 played fully2 of 2 played fully
File type: MKA1 of 1 played fully1 of 1 played fully
Subtitles: SRT3 of 3 played fully3 of 3 played fully
Subtitles: ASS4 of 4 played fully4 of 4 played fully
Subtitles: WebVTT4 of 4 played fully4 of 4 played fully
Subtitles: mov_text1 of 1 played fully1 of 1 played fully
Subtitles: TTML1 of 1 played fully1 of 1 played fully
Subtitles: PGS2 of 2 played fully2 of 2 played fully
Subtitles: DVB subtitles6 of 6 played fully6 of 6 played fully
Subtitles: DVD subtitles1 of 1 played fully1 of 1 played fully
Subtitles: VobSub1 of 1 played fully1 of 1 played fully
Subtitles: DVB teletext subtitles3 of 3 played fully3 of 3 played fully
Subtitles: CEA-608 captions4 of 4 played fully4 of 4 played fully
Delivery: Film135 of 136 played fully135 of 136 played fullyChrome 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 TS20 of 20 played fully20 of 20 played fully
Delivery: Live HLS20 of 20 played fully19 of 20 played fullyFirefox: 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.