Files
vf-cuda-grid/controller
gx 2c0ee8c9e8 controller UI: visual overlay editor + snapshot preview fallback
Поверх preview (image от /snapshot endpoint) добавлен editor layer с
drag-and-drop созданием / перемещением / resize / удалением overlay'ев
через HTTP API (POST/PATCH/DELETE /overlay/{instance}[/{id}]).

Toolbar: draw mode toggle, type (rect-border / rect-fill / dim / text),
color picker, opacity slider. Drag по preview → создание нового overlay
с правильными нормализованными координатами. Клик на overlay → выбор +
drag перемещение, нижний-правый handle = resize, красный × delete.

Cell-bound overlays (Frigate motion borders, dynamic_overlays grafana
panel) не отрисовываются в editor — они уже физически в видео output
и заполняли весь editor area, делая cursor:not-allowed везде. Только
absolute (cell=null) overlays редактируемы.

Preview: HLS отключён.

mediamtx в LL-HLS режиме отдаёт пустые audio fragments
(passthrough-remuxer: "No samples for initPTS at playlist time",
"Duration parsed from mp4 should be greater than zero"). hls.js застревает
с readyState=1, buffered=0. lowLatencyMode:false на клиенте не помог —
mediamtx сам делит на video1_stream.m3u8 + audio2_stream.m3u8 на server
side. Diagnosed через Playwright + hls.js debug logs.

Заменено на <img> с polling /snapshot/{instance} (~700ms request, де-факто
~5s из-за времени ffmpeg RTSP+PNG, но достаточно как reference для
overlay positioning).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-26 17:06:36 +01:00
..

cuda-grid-controller

Control-plane sidecar для vf_cuda_grid FFmpeg filter. Transforms MQTT / HTTP REST commands от Home Assistant / Node-RED / custom apps в FFmpeg process_command через ZeroMQ. Publishes state + events наружу для bidirectional integration.

Статус: Phase 3 work-in-progress — basic skeleton + HA Discovery + ZMQ command bridge. Phase 4+ добавит overlays, audio orchestration.

Что умеет (Phase 3)

  • MQTT subscribe cuda_grid/cmd/<instance>/layout/set → ZMQ send → FFmpeg layout switch
  • MQTT publish cuda_grid/state/<instance>/layout (retained) + cuda_grid/event/.../layout_switched
  • HA MQTT Discovery — select.layout + sensor.current_layout + binary_sensor.online per instance
  • HTTP REST API: /health, /layouts, /state, POST /layout/{instance}/set
  • Multi-instance (несколько FFmpeg pipelines с разными ZMQ endpoints)
  • Auto-reconnect MQTT, LWT для availability tracking

Использование

pip install -e .

export MQTT_USERNAME=mqtt
export MQTT_PASSWORD=secret
cuda-grid-controller --config examples/controller.yaml

FFmpeg side — как подключить cuda_grid + zmq filter

ffmpeg -i cam1.mp4 -i cam2.mp4 -i cam3.mp4 -i cam4.mp4 \
  -filter_complex "
    [0:v][1:v][2:v][3:v]cuda_grid=layout=quad,
    zmq=bind_address=tcp\\\\://127.0.0.1\\\\:5555
  " \
  -c:v h264_nvenc out.mp4

(После этого controller с zmq_endpoint: tcp://127.0.0.1:5555 сможет переключать layout командой cuda_grid@... layout six_grid.)

HA dashboard

После startup controller'а — в Home Assistant появятся entities:

  • select.cuda_grid_<instance>_layout — dropdown с layouts
  • sensor.cuda_grid_<instance>_current_layout — текущий выбранный
  • binary_sensor.cuda_grid_controller_online — online/offline

Roadmap

Phase Что
3 (this) Basic skeleton + HA Discovery + ZMQ bridge для layout switching
4 Overlay API (rect/text/icon через side data)
5 Rich overlays (image/dim/graph/chat) + privacy filtering
6 Audio orchestration (state machine, domofon use case)

Полный design: docs/design.md.