Back to Catalog
Jorji49 GitHub avatar

streamtop

Terminal UI for diagnostics of live HLS, DASH, and IPTV streams

Overview

Terminal UI for diagnostics of live HLS, DASH, and IPTV streams

Terminal HLS, DASH, and IPTV stream monitor. Wire probes, TR 101 290, SCTE-35, Prometheus metrics. Rust CLI/TUI.

From the maintainer

Origin story

Diagnosing live stream issues (latency drift, CDN cache misses, broken manifests, SCTE-35 ad splices) required switching between packet analyzers like Wireshark that lack video context, or tools like ffprobe and curl that download multi megabyte media chunks just to inspect basic container metadata. There was no lightweight, terminal-native tool designed specifically for real time broadcast and OTT stream health.

First workflow

Run `streamtop <STREAM_URL>` against any live HLS, DASH, or MPEG-TS feed. In the TUI, inspect the real-time TTFB network breakdown (DNS, TCP, TLS, TTFB), CDN edge cache hit/miss status, audio track metadata, and cross segment GOP keyframe cadence without wasting bandwidth.

Design choice

Zero payload wire probing: instead of downloading full 5-10 MB media segments, streamtop uses targeted HTTP Range requests (~2-64 KB) to decode fMP4 atoms and MPEG-TS headers directly on the wire. Built with Tokio and Ratatui, it runs at sub-millisecond latency with near-zero CPU and memory overhead.

Roadmap

Deeper Low-Latency HLS (LL-HLS) part inspection, automated PTS audio/video sync drift measurement, and native packaging completion across official package repositories.

Latest Release

v1.5.1
Released: Sep 9, 2026

streamtop v1.5.1

CDN edge classify expansion and poller module split. Summary schema v6 unchanged.

Changes

  • CDN providers: JOCDN, Medianova, Edgio, Lumen, Gcore (HIT/MISS from edge headers)
  • ManifestPoller moved to src/engine/poller/ (HLS/DASH/segment/http modules)
  • Hermetic fixtures: AES-128 key playlist, DASH UTCTiming, CDN 302, media-sequence gap
  • Docs: Limits section; TUI shows linter score (JSON SHI fields frozen)

Install

cargo install streamtop --version 1.5.1

GitHub Release binaries: https://github.com/Jorji49/streamtop/releases/tag/v1.5.1

Discussions

0 comments
Loading comments...
Alvin By Alvin