HLS stream analyzer that tells you what's wrong and how to fix it. Cache issues, keyframe alignment, CDN behavior, ABR selection - with specific, actionable recommendations.
Download Quick Start
Downloads segments. You get files, but zero insight into delivery quality.
Reads metadata. Tells you the codec, not if your CDN is actually caching.
Measures delivery truth. TTFB, cache hits, P95 throughput. Plus how to fix issues.
Don't just see problems - understand exactly how to fix them
Cache Warnings: ! 0% cache hit rate - check cache key configuration or TTL
Know immediately when CDN caching isn't working, with specific guidance on Cache-Control headers, TTL settings, and Vary header issues.
Playlist Warnings: ! 5 segment(s) don't start with keyframe
Catch slow channel change issues before viewers complain about black frames. Get encoder GOP configuration recommendations.
ABR Simulation: Recommended: 1080p @ 4712 kbps Safe Fallback: 720p @ 2493 kbps (p95)
Risk assessment based on P95 throughput (worst 5%), not averages that hide problems. Know which variants may rebuffer.
Live Stream: Est. Live Latency: 18.2s Segments Behind: 3
The first question everyone asks: "What's my latency?" Glass-to-glass estimation using EXT-X-PROGRAM-DATE-TIME.
HTTP-level analysis without video decoding. Minimal CPU usage.
| Flag | Default | Description |
|---|---|---|
--output, -o | console | Output format: console or json |
--segments, -n | 10 | Number of segments to fetch |
--variant, -v | -1 | Variant index: -1 = highest, 0 = lowest |
--parse-segments | false | Parse TS/fMP4 for keyframe detection |
--duration, -d | 30s | Maximum analysis duration |
--error-threshold | 0 | Exit code 2 if error rate > n% |
--latency-threshold | 0 | Exit code 3 if TTFB > n ms |
--throughput-threshold | 0 | Exit code 4 if throughput < n kbps |
--header, -H | - | Custom HTTP header (repeatable) |
--insecure, -k | false | Skip TLS certificate verification |
Gate deployments based on stream quality thresholds
v1.0.0 - Single binary, no dependencies
Free for personal and non-commercial use. Contact us for commercial licensing.
On macOS/Linux: chmod +x wink-hls-stats-*
Automatically detects CDN provider, cache status, and edge location
Analyzing HLS stream delivery at the HTTP level. See TTFB, throughput, cache behavior, and get recommendations to fix issues.
No. It parses TS/fMP4 headers for keyframe detection but doesn't decode video. Minimal CPU usage.
Your worst 5% of requests. Averages hide problems. P95 shows real-world worst-case performance.
Uses EXT-X-PROGRAM-DATE-TIME to estimate glass-to-glass latency. Shows segments behind live edge.
Analyzes two streams side by side. Great for origin vs CDN or evaluating CDN providers.
Use -H "Authorization: Bearer ..." for authenticated streams. Can repeat for multiple headers.
Use --output json for machine-readable output. Perfect for automation and log aggregation.
Yes. HLS Stats analyzes delivery/CDN. RTSP Stats analyzes ingest/cameras. Together: full visibility.