Files
vf-cuda-grid/controller
gx 48eb62bddc controller: UI-toggle audio output + astreamselect decouple (Phase 7 Вариант 2)
Web UI checkbox в Audio source карточке: «вывод аудио в стрим». Off →
TV получает silence + downstream audio chain isolated от live-audio RTSP
(нестабильный sidecar поток больше не блокирует video pipeline).

Изменения:
  state.InstanceState: + audio_output_enabled (default True)
  config.InstanceCfg:
    + audio_output_volume_target (default volume@output_audio)
    + audio_input_select_target (default astreamselect@audio_input)
  dispatch.set_audio_output_enabled(enabled):
    enabled=False → astreamselect map=1 (anullsrc) + volume=0
    enabled=True  → astreamselect map=0 (live-audio) + volume=1
    Двойная команда: select decouples upstream, volume гарантирует тишину
    на случай если в anullsrc что-то не так.
  http_api: + GET /audio-output/{instance}, POST /audio-output/{instance}
  static/index.html: + checkbox в Audio source header + loadAudioOut/toggleAudioOut

ZMQ smoke test OK. HTTP roundtrip OK.

Сопутствующий pipeline change: docker-compose.phase7.yml — amix заменён
на astreamselect@audio_input (см. localhost-infra commit).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-21 20:44:50 +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.