M3U8 Tester: Play and Diagnose Any HLS Stream

Paste an .m3u8 URL. The tester plays it, then tells you what a player hides: where the sound is, how it is encrypted, and why a download fails.

Test an M3U8 stream

Free and open source. Your browser talks to the stream's server directly: the URL is never sent to Vidora.

Tip: in Chrome DevTools, open the Network tab, filter on m3u8, play the video and copy the first request.

Try:

Convert this stream to MP4

Diagnosis

    An M3U8 tester checks that an HLS playlist loads and plays. This one goes further: it reads the master and media playlists, downloads at most 256 KB of the first segment to see which tracks really exist, tests the AES-128 key, detects DRM, live and on-demand streams, and prints the ffmpeg command that keeps picture and sound together.

    What the tester checks

    A player only tells you whether the video starts. The tester also reads what the player keeps to itself, from the playlists and from the first bytes of a real segment:

    CheckWhat you learn
    Master or media playlistWhether you have the playlist with every quality, or one variant copied from DevTools
    VariantsResolution, bitrate, codecs and frame rate of each quality, and the one a download would use
    Separate audioAn audio track declared with EXT-X-MEDIA:TYPE=AUDIO and its own URI: the most common cause of silent downloads
    Real tracksVideo only, audio only or both, read from the MPEG-TS program table, the fragmented MP4 init segment or raw AAC, MP3 and AC-3
    EncryptionNone, AES-128 (the key URL is fetched and must return 16 bytes), SAMPLE-AES, or DRM
    DRMWidevine, PlayReady and FairPlay keys in the playlist, and CENC-encrypted init segments
    Live or on-demandTotal duration and segment count, Low-Latency HLS, playlists still growing
    Server answersHTTP 403, 404 or 410, a web page returned instead of a playlist, a DASH manifest, an expired signed URL
    OdditiesByte ranges, discontinuities from inserted ads, segments disguised as .jpg or .png

    What the stats mean

    When the preview plays, the Live stats panel under the player refreshes every second and pauses with the video. The Quality list lets you leave the choice to hls.js (Auto) or lock one variant, and the variant playing is highlighted in the Variants table.

    StatWhat it tells you
    Resolution (real)The size of the picture the browser actually decodes. If it differs from the variant's declared RESOLUTION, the playlist describes its qualities wrongly.
    Quality playing and declared bitrateThe variant hls.js plays, whether Auto chose it or you fixed it, and the BANDWIDTH the master playlist declares for it.
    Bandwidth estimateThe download speed hls.js measures on the last segments. Auto picks the best variant whose bitrate fits under it. An estimate below the declared bitrate means stalls are coming.
    Buffer aheadSeconds already downloaded past the playhead. On-demand streams usually build up to about 30 seconds; live streams keep only a few seconds because the edge is close. A buffer that keeps falling to zero is a stall.
    Dropped / decodedFrames the browser had to skip because it could not decode or draw them in time. More than about 1% means the device struggles with this quality or codec, not the network.
    Segments loaded and last segmentHow many segments came in, how long the last one took and its size. A load time close to the segment duration means the connection barely keeps up.
    Stream typeVOD (the playlist ends with EXT-X-ENDLIST), live (a sliding window) or event (a live playlist that keeps every segment).
    Live latency and latency vs targetFor a live stream: how far the playhead is behind the live edge, and how far that is from the latency hls.js aims for, which comes from the segment duration or the playlist's hold-back values.

    The two graphs show the buffer and the bandwidth estimate over the last 60 seconds of playback. Under the diagnosis, the Player events log lists what the player did (playlist parsed, quality switches, first segment) and turns every hls.js error into a probable cause and a next step. Tick Errors and warnings only to hide the rest, or copy the log to paste it in a bug report.

    Why won't my M3U8 stream play?

    Six causes cover almost every failure. Each one leaves a trace in the event log or in the diagnosis:

    1. The server only accepts its own player (CORS). The log says the browser could not read the playlist or the segments "(CORS or network)", and a yellow box offers the alternatives. When the playlist loads but the segments fail, the segment server is the one refusing. The stream may be fine: test it with npx m3u8-doctor in a terminal, where CORS does not apply.
    2. The link expired or needs the site's cookies or Referer (HTTP 403). Signed URLs carry a token and an expiry time. The log shows "Access refused to the playlist (HTTP 403)", or to a segment or the key, and the diagnosis says when a signed URL looks expired. Copy a fresh URL and test it right away.
    3. A playlist or a segment is gone (HTTP 404 or 410). The content was removed, the token expired, or on a live stream a segment already slid out of the window.
    4. The URL is not an HLS playlist. hls.js reports manifestParsingError when the answer does not start with #EXTM3U: a login page, the video page itself, or a DASH manifest. The diagnosis says what the server returned. To find the right address, filter the Network tab of DevTools on m3u8, or drop a HAR file into the M3U8 sniffer, which lists every playlist the page loaded.
    5. The browser cannot decode the codec. HEVC (H.265) plays only where the browser and the hardware decode it, and Dolby audio (AC-3, E-AC-3) is refused by most desktop browsers. The log says the codecs are not supported; the Codecs column of the Variants table shows which variant uses what. ffmpeg still copies such a stream without decoding it.
    6. The stream is encrypted in a way the page cannot open. DRM (Widevine, PlayReady, FairPlay) never plays outside the site's own player, and the diagnosis names the system. With AES-128, a key URL that answers 403 gives keyLoadError: the key server wants the site's cookies or token.

    A stream that plays but keeps pausing is a different problem: the log shows bufferStalledError and the buffer graph drops to zero. Compare the bandwidth estimate with the declared bitrate, then lock a lower quality in the Quality list.

    Why a stream plays but downloads without sound

    Adaptive streams often keep the audio apart from the picture. The master playlist lists the qualities on #EXT-X-STREAM-INF lines and points each of them to an audio group. When that group has its own URI, the video playlist carries pictures only, and the player quietly loads two playlists at once.

    Copy only the video URL into ffmpeg and you get a silent file. The fix is two inputs mapped together:

    ffmpeg -i "video.m3u8" -i "audio.m3u8" -map 0:v:0 -map 1:a:0 -c copy out.mp4

    The tester finds both URLs and prints that command for you. When you paste a single variant, it reads the first segment: if there is no audio track inside, it says so and tells you to go back to the master playlist. Other causes of silent files, such as a muted preview or an audio codec the container cannot hold, are covered in the guide to videos downloaded without sound.

    Reading the result

    AES-128 is not DRM

    AES-128 is the standard encryption of HLS. The playlist names a key URL, and any player allowed to fetch that key can decrypt the segments, ffmpeg included. The tester fetches the key, checks that it is 16 bytes long, and decrypts the start of the first segment to read its tracks. If the key returns 403, the site wants a cookie, a token or a Referer that the request did not carry. The encrypted M3U8 guide walks through those cases.

    Widevine, PlayReady and FairPlay are DRM: the key never leaves a licensed decryption module. The tester names the system and stops there.

    Testing a live stream

    A playlist without #EXT-X-ENDLIST is live. The preview starts near the live edge, and the printed command records from now until you press q, into a .ts file that stays playable even if the recording is cut. A sliding live playlist cannot give back what aired before you started. Once you stop, you can convert the TS recording to MP4 without re-encoding.

    Use it from the command line

    The engine of this page is open source: m3u8-doctor on GitHub, MIT licensed, with no dependencies. In a terminal it is not limited by CORS and it can send the headers a site expects:

    npx m3u8-doctor "https://cdn.example.com/hls/index.m3u8" --referer "https://example.com/watch/42"

    It prints the same diagnosis, quotes the command for bash, zsh or PowerShell, and has a --json mode for scripts. To save the stream without a terminal, the online M3U8 to MP4 converter remuxes it in your browser when its server allows it, and the M3U8 to MP4 guide compares ffmpeg with the other methods.

    Limits worth knowing

    Rather click than type commands?

    Vidora is a Chrome extension that does it in one click. It finds the stream on the page where the video plays, merges separate audio and video into one file, handles AES-128, and refuses DRM.

    On Microsoft Edge? Install it from Edge Add-ons

    Frequently asked questions

    How do I test if an m3u8 link works?
    Paste the .m3u8 URL above and press Test stream. The tester loads the playlist, plays it with hls.js and reports what it found: the variants, whether the audio is separate, the encryption, live or on-demand, and the exact reason when it fails (HTTP 403 or 404, a web page instead of a playlist, a DASH manifest, a blocked key).
    Why does the tester say the stream is blocked by CORS?
    A web page can only read a stream from another site if that site sends an Access-Control-Allow-Origin header, and many video sites only allow their own player. The stream may be fine: run the same test with npx m3u8-doctor, which is not limited by CORS and can send the Referer and cookies, or use the Vidora extension on the page where the video plays.
    Why does my m3u8 play but the downloaded file has no sound?
    Most often the audio is a separate playlist declared with EXT-X-MEDIA TYPE=AUDIO. The player loads both, but a download of the video URL alone gives pictures only. The tester flags it and prints an ffmpeg command with two inputs and -map 0:v:0 -map 1:a:0.
    Is the m3u8 URL sent to your servers?
    No. The page runs in your browser and requests the playlist, the key and up to 256 KB of the first segment directly from the stream's server. Vidora receives nothing about the URL you test.
    Can it test DRM-protected streams?
    It detects Widevine, PlayReady and FairPlay from the playlist keys and from the pssh boxes of fragmented MP4 init segments, then stops. DRM content cannot be saved with ffmpeg, and removing DRM is illegal in most countries.
    Can I test a live m3u8 stream?
    Yes. A playlist without EXT-X-ENDLIST is reported as live, playback starts near the live edge, and the printed command records to a .ts file so it stays playable even if the recording is cut.
    Can I pick the quality and see the bitrate while it plays?
    Yes. Once the playlist loads, the Quality list offers Auto and every variant with its resolution, bitrate and codecs, and the variant playing is highlighted in the Variants table. The Live stats panel shows the real picture size, the declared bitrate, the bandwidth estimate, the buffer, dropped frames and, for a live stream, the latency, with graphs of the buffer and the bandwidth over the last 60 seconds of playback.
    Can I add my own subtitles to the test?
    Yes. Add subtitles loads a WebVTT (.vtt) file from your computer, or an .srt file that the page converts to WebVTT, and shows it over the video. The file is read in your browser and never uploaded. Audio and subtitle tracks declared in the playlist appear in their own lists.
    What do hls.js errors like bufferStalledError or levelLoadTimeOut mean?
    The Player events log translates them. bufferStalledError means playback ran out of buffer because segments arrive more slowly than they play. levelLoadTimeOut means a variant playlist did not load in time, often a live origin that stopped updating. manifestLoadError with HTTP 403 usually means an expired signed URL or a missing Referer, and a fragLoadError without any HTTP status usually means the segment server does not allow other sites (CORS).
    How do I share a stream test with someone?
    Press Copy share link. It copies a link of the form getvidora.com/tools/m3u8-tester/#url= followed by the encoded stream URL, which opens the tester and runs the same test. Browsers do not send the part after # to the server, and the page removes it from the address bar once it has read it. A signed stream URL may expire before the other person opens the link.

    Romain Gouraud, RGC Digital LLC

    Published 2026-10-07, updated 2026-10-09. Tested on the public streams above: the printed commands were run with ffmpeg and the files checked with ffprobe (H.264 video and AAC audio in each).