Skip to content
Projects

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.

How these counts are measured

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 Tools

README.md

Original
streamtop logo

streamtop

Terminal HLS, DASH, and IPTV stream monitor with wire probes, health checks, SCTE-35, TR 101 290, and Prometheus metrics.

Terminal Trove Tool Of The Week

Awesome Ratatui Awesome Rust

Crates.io Release Downloads License: MIT

streamtop HLS DASH IPTV terminal dashboard demo

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, and streamtop scte35 for 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.