Jorji49/streamtop
Jorji49/streamtop has 128 GitHub stars and 4 forks. GitHot measured +1 stars in 24 hours, +2 in 7 days, and +5 in 15 days. Last checked 2026-11-18 03:44 UTC. Last push 2026-11-10.
Measured star growth
- in 24h
- +1
- in 7 days
- +2
- in 15 days
- +5
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Terminal monitor for live HLS, DASH, and IPTV streams. Wire probes, TR 101 290, SCTE-35, Prometheus and OpenTelemetry metrics. Rust CLI and TUI.
Developer ToolsREADME.md
Originalstreamtop
Terminal HLS, DASH, and IPTV stream monitor with wire probes, health checks, SCTE-35, TR 101 290, and Prometheus metrics.
Documentation | Install | IPTV checking | CI | Comparison | Changelog
streamtop is a Rust CLI and terminal UI for monitoring live video streams. Point it at an HLS playlist (.m3u8), an MPEG-DASH manifest (.mpd), an IPTV channel list (.m3u, .json, .yaml), or a WHEP endpoint. It shows segment timing, codec data read from the wire, SCTE-35 ad markers, CDN behavior, and health scores without a browser or GUI player.
Install
cargo install streamtop # or: cargo binstall streamtop
brew tap Jorji49/tap && brew install streamtop # macOS / Linux
scoop bucket add streamtop https://github.com/Jorji49/streamtop && scoop install streamtop
docker run -it --rm ghcr.io/jorji49/streamtop:latest <URL>
Prebuilt binaries for Linux (x86_64 and arm64, glibc and musl), macOS (Apple Silicon and Intel), and Windows x86_64 are on GitHub Releases. Arch Linux, winget, and source builds are covered in the install guide. streamtop completions <bash|zsh|fish|elvish|powershell> prints a completion script and streamtop man prints the man page.
Usage
# Live dashboard for HLS or DASH
streamtop "https://example.com/master.m3u8"
streamtop "https://example.com/manifest.mpd" --tr101290 --probe-sei
# IPTV list: channel picker
streamtop ./channels.m3u
# Check every entry: table, JSON or CSV, a playlist of working ones, exit 1 on dead
streamtop check ./channels.m3u --alive-out working.m3u --fail-on-dead
# Decode one SCTE-35 cue (Base64, hex, or an HLS tag line)
streamtop scte35 "/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo="
# Headless PASS/FAIL for CI (JSON or SARIF)
streamtop <URL> --summary --summary-format json --timeout 10
# Prometheus /metrics on 127.0.0.1:9184
streamtop <URL> --prometheus
What it checks
- HLS (including LL-HLS parts) and MPEG-DASH, live and VOD
- Segment DNS / TCP / TLS / TTFB timing and CDN HIT/MISS for 12 CDNs
- ABR ladder versus the bitstream: resolution, FPS, GOP, audio
- TR 101 290 P1/P2 on MPEG-TS, SEI captions and HDR metadata
- IPTV playlist checks with
streamtop check - SCTE-35 in HLS tags and DASH
emsg, with mismatch detection, andstreamtop scte35for single cues - Side-by-side compare and multi-CDN live-edge skew
- Exports: HTML/JSON reports, HAR, curl, SARIF, Grafana dashboard
- Prometheus, OpenTelemetry, webhooks, and a multi-stream agent
streamtop reads headers and the first bytes of each segment. It does not decode media, and it does not take SRT, RTMP, or UDP input. See Limits and how it compares with TSDuck, ffprobe, threefive, and iptv-checker.
Contributing
Bug reports and pull requests are welcome. See CONTRIBUTING.md. Questions and ideas go to Discussions.
License
MIT.
