Skip to content
CodoPlayer

M3U8 Player and HLS Manifest Inspector

Paste an .m3u8 address or the manifest text and see what is inside: the qualities, the audio and subtitle tracks, the segment length and whether it is live. Press Play to watch one stream when your browser is allowed. It runs in your browser and sends nothing to us.

What this page does and does not do

Your browser, not our server, asks the address you typed for its manifest, the small text file that lists a stream's qualities, audio tracks and pieces. The text is read in a background thread and the page says what kind of file it is. Press Play and the page loads the HLS player library that the CodoPlayer web player also uses, only then, and your browser plays the stream directly from its source. Nothing you type or paste is sent to us, and the page never plays, fetches or relays anything through our servers.

Channel playlist or HLS manifest?

Both are text files that start with #EXTM3U, but they are different things. A channel playlist (what the M3U Validator and Playlist Editor handle) lists many channels, each with an #EXTINF line and an address. An HLS manifest describes one stream. The tool tells them apart by its tags: #EXT-X-STREAM-INF marks a master playlist (the qualities of one stream), #EXT-X-TARGETDURATION marks a media playlist (the pieces of one quality), and #EXTINF lines without either are a channel playlist. If you paste a channel playlist, the page says so and counts its entries.

When the browser refuses

A web page may read another site's file only if that site allows it (CORS), and a page opened over https may not request an http address. These rules belong to the browser. When they stop the request, this page says which one it could tell and what you can really do: ask the source for an https address, paste the manifest text instead, or use a CodoPlayer app, which is not bound by the page rule. It never retries through our server. A 401 or 403 answer means the source wants a login or refuses the request; the page cannot and does not try to get around that, and it does not play protected (DRM) streams.

Example

Input, an invented master manifest (press "Fill in an example" to load it):

#EXTM3U
#EXT-X-VERSION:6
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="aud",NAME="English",LANGUAGE="en",DEFAULT=YES,AUTOSELECT=YES,URI="audio-en.m3u8"
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="aud",NAME="Deutsch",LANGUAGE="de",AUTOSELECT=YES,URI="audio-de.m3u8"
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="sub",NAME="English",LANGUAGE="en",URI="subs-en.m3u8"
#EXT-X-STREAM-INF:BANDWIDTH=2500000,AVERAGE-BANDWIDTH=2200000,RESOLUTION=1280x720,FRAME-RATE=25,CODECS="avc1.64001f,mp4a.40.2",AUDIO="aud",SUBTITLES="sub"
720p/index.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=5000000,RESOLUTION=1920x1080,FRAME-RATE=25,CODECS="hvc1.1.6.L120.90,ec-3",AUDIO="aud",SUBTITLES="sub"
1080p/index.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=800000,RESOLUTION=640x360,CODECS="avc1.42c01e,mp4a.40.2",AUDIO="aud"
360p/index.m3u8

The summary line the tool writes for it:

HLS master playlist (version 6): 3 quality levels from 0.8 to 5.0 Mbit/s, 2 audio tracks, 1 subtitle track.

Below it, a table lists the three quality levels with size, frame rate and codecs (H.264, HEVC and AAC, E-AC-3 named in plain words), and the audio and subtitle tracks with language and default flag. The tool reads manifests of up to 2 MB.

This is not the Stream Tester: that tool asks the stream from our server and measures the path from the provider to us. This page runs only in your browser.

How it works

  1. 1Type or paste a stream address, or paste the manifest text.
  2. 2Press Inspect to read the manifest, or Play to watch the stream; your browser talks to the source directly.
  3. 3Read the qualities, tracks and timing, or the reason the browser was refused.

What the results mean

The summary names the kind of file. A master playlist lists the quality levels of one stream with their speed, picture size and formats, plus its audio and subtitle tracks. A media playlist lists the pieces of one quality: a finished video has an end marker, a live stream does not and its list slides forward. A channel playlist is a list of many channels, not one stream.

Common problems

If the browser is refused, the page names the reason it can tell: the source does not allow web pages to read it, an http address on an https page, or a 401, 403 or 404 answer. Fresh addresses often carry a token that expires. A stream that loads but shows no picture or no sound usually uses a format this browser cannot decode: check it in the Browser Playback Test.

Step-by-step guide: M3U or Xtream link will not play in the browser: CORS and mixed content.

Example input

An example HLS stream address. Use a working stream address to try it.

https://example.com/live/index.m3u8

You get: If your browser can read the manifest, the tool describes what it holds. With a supported stream, Play uses your browser to play it directly from its source.

Messages this tool can show

Messages reported by the M3U8 Player and HLS Inspector
MessageWhat it meansWhat to do
Type a stream address, or paste the manifest text.Both fields were empty.Type an .m3u8 address, or paste the text of a manifest.
This page is opened over https and the address starts with http://. Browsers block that mix, so the request was not made.A page opened over https may not request an http address.Ask the source for an https address, paste the manifest text, or use a CodoPlayer app.
The source answered, but it does not allow web pages from other sites to read its files (CORS).The browser withheld the answer because the source did not allow this page.Paste the manifest text, or use a CodoPlayer app; the page cannot change the source's rule.
The browser could not reach the address at all.Mistyped address, a server that is down or blocks your network, or an invalid security certificate.Check the address and open it in another tab.
The source answered 401 or 403.The source wants a login, refuses this request, or the address has expired.Get a fresh address from where you got this one; the page does not try to get around it.
The address answered with a web page, not a manifest.Often a login page or an error page.Check that the address ends in a stream file, not a page.
The answer is larger than 2 MB.Over the tool limit; probably a media file.Use the address of the manifest, not of a video file.
This browser cannot play HLS through Media Source and has no built-in HLS player.The player cannot start here.Check the Browser Playback Test, or use a CodoPlayer app.

Questions about the M3U8 Player and HLS Inspector

How do I play an M3U8 link in the browser?

Type the .m3u8 address and press Play the stream. Your browser asks the source directly, and the page loads the HLS player only then. It works only when the source allows web pages to read it. If not, the page says why, and pasted manifest text can still be inspected.

What is the difference between an M3U playlist and an M3U8 stream?

Both are text files that start with #EXTM3U. A channel playlist lists many channels, each with an #EXTINF line and an address. An HLS manifest describes one stream: a master lists its qualities and tracks, a media playlist lists its pieces. The page tells them apart by those tags and says which it found.

Why does the page say my stream is blocked?

A browser lets a page read another site's file only if that site allows it, and it refuses http addresses on https pages. The page names the reason it can tell: cross-site rules, mixed content, or a 401 or 403 answer. It never retries through our server and cannot change what a provider allows.

Does this tool send my address or manifest to your server?

No. Your browser asks the source itself, a background thread reads the text, and nothing is uploaded, stored or counted by the tool. Our server never fetches the address and never relays the stream. The page itself is loaded from our server like any other page, and the site menu works as it does elsewhere.