2 releases 2 tags

RSS feed

• v1.0.0 2c186bfcf0

  Compare

  v1.0.0 Stable

  jd released this 2026-07-12 21:07:59 +00:00 | 3 commits to main since this release

  Initial public release — a low-dependency, stdlib-only terminal dashboard for Frigate NVR hosts.

  Added

  • Host + Frigate dashboard. Block-bar graphs for CPU, memory, disk I/O, network throughput +
    errors, NVIDIA GPU (util / mem / temp, one set per detected GPU), CPU iowait, and load — plus
    Frigate metrics: skipped frames, detector inference time, detection / camera FPS, online/offline
    cameras, and a detector-throughput supported-camera estimate.
  • Boxed header table grouped into identity (host, uptime, OS, kernel), hardware (CPU, memory,
    GPU model + driver), Frigate (version, cameras, supported estimate, detector), and
    streams/storage — with a live warnings status line and a per-timeframe Detections breakdown
    (person / vehicle / animal / recognised face / recognised plate) from /api/events.
  • Readable graphs — each plot fills the full width over the configured timeframe with a
    -span … now time axis, severity-coloured fills and values (green / amber / red vs warn/crit
    thresholds), dashed threshold guides, ▲/▼/→ trend arrows, an endpoint marker, midpoint axis
    labels, and no sensor panels for absent hardware. skipped fps and NET errors render red on
    any nonzero value.
  • Collapsible sections (s / w / f), with System and Network collapsed by default so the
    Frigate graphs fit smaller terminals; live terminal resizing is handled without dropping graphs.
  • Three renderers: block bars (default), dense Braille (--braille), and plain ASCII (--ascii).
  • Auto-detection + overrides: finds the Frigate API (HTTP/HTTPS on common ports), all NVIDIA
    GPUs, and the busiest disk / interface; pin them with --frigate-url, --disk, --net-iface.
  • CSV export (--csv), a one-shot --snapshot for headless / cron use, live history-timeframe
    switching (1 / 5 / p / t), and memory / network unit toggles (m / n).
  • Packaging — installable via the Forgejo PyPI registry with a frigate-top entry point;
    still runnable as a single stdlib-only script.

  Security

  • TLS certificates are verified for remote HTTPS Frigate instances; verification is relaxed only
    for loopback hosts (where self-signed certs are the norm) or with --insecure.
  • The --debug log is written to a per-user directory ($XDG_RUNTIME_DIR) and opened with
    O_NOFOLLOW, avoiding a predictable world-writable path.
  • Subprocess calls use fixed argument lists (no shell); YAML is parsed with safe_load.

  Downloads

  • Source code (ZIP)
    0 downloads
  • Source code (TAR.GZ)
    0 downloads