Wanyard

Website: https://wanyard.com

RTSP camera capture with BITC-stamped video, YOLO object detection, live HLS, and a LAN web viewer.

Quick start

git clone https://github.com/blowhacker/wanyard.git
cd wanyard
docker compose up --build -d

Open http://localhost:8091/settings to add cameras. YOLO model downloads automatically on first run.

For GPU acceleration, copy the override file:

cp docker-compose.gpu.yml docker-compose.override.yml
docker compose up --build -d

What it does

• Burns BITC Unix time into each frame before recording and detection
• Records stamped camera streams as continuous MP4 segments
• Serves rolling live HLS streams for browser playback
• Runs live YOLO detection plus MP4 backfill, with detections keyed by BITC time
• Live wall (god view) — all cameras at once on the landing page, instant load with near-zero-latency WebRTC; click a camera to open its full viewer
• Web UI: live view, timeline filmstrip, event feed with class filtering, clip export
• Auto-cleanup of old footage by age or disk usage

Architecture

Ingest: camera → go2rtc → mediamtx → stamper → recorder/yolo. go2rtc is the single camera puller; it serves the live wall over WebRTC directly (instant, low latency) while mediamtx sources from it for recording/BITC/HLS — no extra camera pull.

Main services in docker-compose.yml:

• app (wanyard) — web server, APIs, recording, HLS/MP4 serving
• go2rtc — camera ingest; serves the live wall over WebRTC (WHEP)
• mediamtx — RTSP relay (sources from go2rtc), live HLS
• stamper — burns BITC into frames and republishes stamped streams
• yolo (wanyard-yolo) — live detector, thumbnail crops, MP4 backfill

Commands

wanyard serve        # web server, APIs, recording
wanyard stamp        # BITC stamper
wanyard yolo-serve   # YOLO live detection + MP4 backfill

Tests

Run the fast unit suite:

python3 -m unittest discover -s tests -v

Run the isolated recorder fault suite with real FFmpeg and MediaMTX processes:

./scripts/test-recorder-faults.sh

The fault suite uses a separate Compose project, synthetic RTSP publishers, temporary databases, and temporary video directories. It does not read camera configuration or production footage.

Web UI

• http://localhost:8091 — live wall (all cameras); click one for its viewer
• http://localhost:8091/?source=<id>&live=1 — single-camera timeline viewer + event feed
• http://localhost:8091/settings — add/remove cameras, system status, cleanup config