streamtop

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

Install

cargo install --path .

Or build a release binary:

cargo build --release

Windows: if the linker fails, put WinLibs MinGW on your PATH, then rebuild.

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 media bitstream when it can be read.

Commands

# Live dashboard

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


# Compare two feeds side by side

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


# Webhook alerts (Slack / Discord / any HTTP endpoint)

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


# Channel list audit → audit_report.json / .csv

streamtop ./channels.m3u --audit


# Headless pass/fail (CI)

streamtop <URL> --summary --timeout 10


# Prometheus metrics on :9090/metrics

streamtop <URL> --prometheus


# Grafana dashboard JSON (import; scrape streamtop --prometheus)

streamtop --export-grafana

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

Keys

License

MIT — see LICENSE.