Skip to content

v2.0.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 15 Jun 11:38
v2.0.0
b349039
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

A ground-up rewrite. One Python engine now runs everywhere — in your browser on Pyodide
or on a server on CPython — with every runtime difference behind a single Platform
contract. Nothing from 1.x is migrated: a 2.0 hub starts from a fresh configuration.

Added

  • Local mode — the full engine runs in the browser (Pyodide, with
    LiteRT.js WASM inference). Nothing is
    installed and no frame leaves the device; a
    live demo deploys to GitHub Pages on
    every release.
  • Klipper (Moonraker) integration alongside OctoPrint: read printer state, pause or
    cancel jobs, with per-printer thresholds, consecutive-detection counts and cooldowns.
  • ntfy, Telegram and Discord notifications, each carrying a snapshot of the defect.
  • Live video via MediaMTX — pull any RTSP/RTMP/HTTP source, publish this device's
    camera over a WebSocket, auto-discover streams already pushed to the server. Playback
    is HLS served through the hub's own port, so a single HTTPS port — and the auth proxy
    in front of it — covers the dashboard, control and video.
  • Print-aware gating — printers linked to a service are only watched while they
    actually print; inference stands by when they sit idle.
  • Fail-safe watchdog — warnings on the dashboard and through notification channels
    when a camera drops, a feed freezes or a printer service stops answering; a failed
    pause is announced, never swallowed.
  • Fair multi-camera scheduling — inference capacity is shared evenly across as many
    cameras as the hardware sustains.

Changed

  • The UI is rewritten in React + TypeScript; one dashboard serves both modes.
  • Inference moved from PyTorch/ONNX Runtime to LiteRT (TFLite): a ≈5 MB ShuffleNetV2
    encoder classified by nearest prototype, with per-printer sensitivity and threshold
    sliders mapped to prototype distances.
  • Cameras are network streams through MediaMTX instead of host devices, so the container
    no longer needs --privileged.
  • Securing a hub is delegated to an identity layer in front — Tailscale, Cloudflare
    Access or oauth2-proxy, documented step by step in
    docs/deployment.md
    — instead of in-app SSL certificates and tunnel management.
  • Docker is the only supported distribution: multi-arch (amd64, arm64) images on
    ghcr.io/oliverbravery/printguard,
    with a compose file that includes MediaMTX.

Removed

  • The PyPI package — use the Docker image, or local mode for an install-free run.
  • Web push notifications and VAPID key setup — replaced by ntfy, Telegram and Discord.
  • The setup page's SSL certificate generation and built-in Cloudflare/ngrok tunnelling —
    replaced by
    docs/deployment.md.
  • 32-bit ARM (arm/v7) images — arm64 (Raspberry Pi 4/5) remains supported.
Assets 2
Loading