V2

2026-10-04 11:45:14 -05:00
parent f60ec71e78
commit 2c7574f030
6 changed files with 533 additions and 70 deletions
@@ -0,0 +1,26 @@
+# Audio Router
+
+This daemon owns the physical PipeWire/JACK links for sanctuary audio. MQTT
+topic names and payloads remain under the existing `audio/player` base topic.
+
+YTPlayer audio follows one path:
+
+```text
+MPV -> ytplayer_bus -> Audio Router -> HDMI, analog, or disconnected
+```
+
+The virtual sink definition lives at
+`pipewire/20-ytplayer-bus.conf`. Install it as
+`~/.config/pipewire/pipewire-pulse.conf.d/20-ytplayer-bus.conf`; PipeWire Pulse
+will recreate the bus after restarts.
+
+Preset policy:
+
+- `service`: mixer to HDMI only; YTPlayer disconnected
+- `video`: YTPlayer to HDMI
+- `announcements` and `aux_only`: YTPlayer to analog
+- `mute_all`: YTPlayer disconnected
+
+The router starts muted, restores the retained `audio/player/mode/state` once,
+and periodically reconciles missing links. YTPlayer is configured as an
+exclusive source, so a preset that enables both HDMI and analog is rejected.