streamtop

Live HLS, DASH, and IPTV stream diagnostics in the terminal.

Installation

Rust

cargo install streamtop

cargo install cargo-binstall

cargo binstall streamtop

Windows (Scoop)

scoop bucket add streamtop https://github.com/Jorji49/streamtop
scoop install streamtop/streamtop

Windows (Winget)

Package submission is in review (PR #424450 for 0.3.2). Manifests for 0.3.3 live under dist/winget/ and will be submitted after merge. After the package is available:

winget install streamtop

macOS / Linux (Homebrew)

brew tap Jorji49/tap

brew install streamtop

brew install --formula https://raw.githubusercontent.com/Jorji49/streamtop/main/Formula/streamtop.rb

Arch Linux (AUR)

A packaging template lives at dist/aur/PKGBUILD. The package is not published to the AUR yet.

Docker

The image contains the CLI binary only (no mpv / ffplay). Quick Play is unavailable in the container.

docker run -it --rm ghcr.io/jorji49/streamtop:latest <URL>

docker run --rm -p 9184:9184 ghcr.io/jorji49/streamtop:latest \

  <URL> --prometheus --metrics-bind 0.0.0.0

Debian / Ubuntu

cargo install cargo-deb

cargo deb

sudo dpkg -i target/debian/streamtop_*.deb

From source

Release binaries: latest release

git clone https://github.com/Jorji49/streamtop.git

cd streamtop

cargo install --path .

Quick start

streamtop "https://example.com/master.m3u8"

streamtop "https://example.com/manifest.mpd" --probe-headers

streamtop "./channels.m3u"

--probe-headers downloads only the start of each segment (faster; enough for header and wire checks).

What you see

FPS comes from the playlist (FRAME-RATE / @frameRate) when present; otherwise from the bitstream when readable. GOP interval is estimated from keyframe PTS across consecutive segments (Fixed vs Variable cadence). Audio codec, sample rate, and channels come from ADTS, fMP4, or MPEG-TS PMT when present in the probe window.

Commands

# Live dashboard

streamtop <URL> [--probe-headers] [-H "Key: Value"] [-A user-agent] [-i MS]


# Compare two feeds

streamtop --compare <URL_1> <URL_2> --probe-headers


# Webhook alerts (Slack / Discord / HTTP). Private and metadata hosts are blocked by default.

streamtop <URL> --webhook https://hooks.example/x --alert-on stall,shi_below_70,http_5xx

# Local webhook testing only:

streamtop <URL> --webhook http://127.0.0.1:9999/hook --allow-insecure-webhooks


# Channel list audit -> audit_report.json / .csv

streamtop ./channels.m3u --audit


# Headless pass/fail (CI). JSON schema: schemas/summary.v1.json

streamtop <URL> --summary --summary-format json --timeout 10


# Ticket attach: curl / HAR (secrets redacted)

streamtop <URL> --export-curl --probe-headers

streamtop <URL> --export-har incident.har --timeout 10


# Named profile from ~/.config/streamtop/config.toml (see config.example.toml)

streamtop <URL> --profile cdn


# Prometheus on 127.0.0.1:9184/metrics

streamtop <URL> --prometheus

streamtop <URL> --prometheus 9184 --metrics-bind 0.0.0.0 --metrics-token "$STREAMTOP_METRICS_TOKEN"

# Scrape with: curl -H "Authorization: Bearer $STREAMTOP_METRICS_TOKEN" http://host:9184/metrics

# Query ?token= is not supported (Bearer header only).


# Optional DRM license / LA_URL TTFB probe

streamtop <URL> --probe-drm --summary


# Grafana dashboard JSON

streamtop --export-grafana

Alert kinds for --alert-on: stall, shi_below_70, http_5xx, mismatch, ad_start.

Keys

Compare mode: Space pause/resume (ring buffer), d detail, l log focus, c curl, h HAR, Tab focus pane.

License

MIT. See LICENSE.