What the HLS stream tester checks
| Check | What it shows | Why it matters |
|---|---|---|
| Manifest | Whether the .m3u8 file loads and starts with valid HLS tags. | A stream cannot play if the master or media playlist is missing, expired, or malformed. |
| Variant tracks | Resolution, bandwidth, frame rate, and codec values from each track. | This confirms adaptive bitrate ladders and explains browser codec failures. |
| Segments | Sampled .ts or .m4s segment pass/fail results. | A manifest can be valid while individual media segments are dead or blocked. |
| Encryption | Whether the stream references AES-128 keys or protected media. | Encrypted HLS also needs key URLs to be reachable through the same access path. |
| Live vs VOD | Whether the playlist has #EXT-X-ENDLIST or continues updating. | Live streams fail differently from VOD archives and need different retry expectations. |
| Browser access | CORS, mixed-content, and hotlink symptoms during playback. | These are browser-specific failures that VLC and desktop tools may not reveal. |
How to test an HLS stream online
- 1Paste the HLS URLPaste the .m3u8 link into the player and start with direct playback. A reachable stream should at least load the manifest and attempt media playback.
- 2Watch for browser-only failuresIf VLC plays the same URL but the browser fails, suspect CORS, mixed content, blocked keys, or hotlink protection instead of a fully dead stream.
- 3Enable the proxy when neededTurn on the CORS proxy when the browser cannot read the manifest, key, or segment responses. Keep the full HLS session on the same proxy path.
- 4Run the health reportUse the validator to list variants, segment duration, encryption, live/VOD status, and sampled dead segments.
- 5Map the failure to the fixUse CORS errors for proxy work, 403 responses for Referer checks, segment failures for CDN investigation, and codec failures for player compatibility testing.
Why test HLS in a browser instead of only VLC
VLC is useful for confirming whether a stream can be decoded, but it does not reproduce browser security rules. A web HLS tester shows the same CORS, HTTPS, header, and media-source constraints your actual web player will hit, which makes it better for front-end video debugging.
What makes a useful HLS health report
A useful HLS report expands the master playlist, identifies every bitrate track, checks live/VOD status, detects encryption, measures segment timing, and samples media segment availability. Checking only the first .m3u8 response misses the failures that often happen after playback starts.
When to use the custom Referer path
If the manifest or segments return 403 unless they are requested from the original site, the stream is probably hotlink-protected. Enable the proxy, set the page URL where the stream normally plays as Referer, and rerun playback plus the health report through that path.
Related HLS debugging pages
- M3U8 validator is the dedicated health-report tool for tracks, bitrate, encryption, and dead segments.
- HLS CORS error explains why a stream may fail in the browser even when it works in VLC.
- Custom Referer M3U8 player covers streams that need a forwarded Referer or User-Agent to load.
Frequently asked questions
What is an HLS stream tester?
An HLS stream tester is a browser tool that loads an M3U8 URL, attempts playback, and checks the manifest, variant tracks, encryption, live/VOD status, and media segment availability.
Why does an HLS stream work in VLC but not in Chrome?
Chrome enforces browser security rules such as CORS and mixed-content blocking. VLC does not, so a stream can be valid media but still fail in a web player until CORS or proxy routing is fixed.
Can the tester detect dead HLS segments?
Yes. The health report samples media segments and reports failures. For accurate results, enable the CORS proxy when the segment origin does not allow direct browser requests.
Does the HLS tester support encrypted streams?
It can test normal AES-128 HLS streams when the key URL is reachable. It does not bypass DRM systems such as Widevine, FairPlay, or PlayReady.
Is this HLS stream tester free?
Yes. It is free, ad-free, requires no account, and runs in the browser. The optional proxy is only used when you enable it for CORS or Referer testing.