Tighten audio fix docs: 0.5+ requirement, 3-piece framing

- Correct misleading "covers wireplumber 0.4" claim — the SPA-JSON rule
  format is 0.5+ only; Omarchy ships 0.5.x.
- Add Wireplumber 0.5+ to Requirements; note kernel snd-aloop check.
- Reframe the audio fix section as three required pieces — DeckLink→ALSA
  config, snd-aloop+bridge, wireplumber default-exclusion rule — with
  explicit per-piece failure modes so future readers know skipping any
  one isn't safe.
This commit is contained in:
28allday 2026-05-01 15:28:50 +01:00
parent 2173563632
commit 0e7eeddc27
2 changed files with 13 additions and 5 deletions

View file

@ -554,9 +554,10 @@ EOF
# DaVinci Resolve aloop — keep snd-aloop out of the default-sink rotation. # DaVinci Resolve aloop — keep snd-aloop out of the default-sink rotation.
# Managed by Omarchy_resolve_v2.sh. Without this, wireplumber promotes # Managed by Omarchy_resolve_v2.sh. Without this, wireplumber promotes
# aloop to default whenever Resolve makes it RUNNING, and the bridge loops # aloop to default whenever Resolve makes it RUNNING, and the bridge loops
# audio back into aloop instead of reaching real hardware. Setting both # audio back into aloop instead of reaching real hardware. SPA-JSON rule
# dont-fallback (older) and disable-fallback (newer) covers wireplumber # format requires wireplumber 0.5+ (Omarchy ships 0.5.x). Setting both
# 0.4 and 0.5+. # node.dont-fallback and node.disable-fallback covers minor key renames
# across the 0.5.x series.
monitor.alsa.rules = [ monitor.alsa.rules = [
{ {
matches = [ matches = [

View file

@ -16,6 +16,10 @@ Handles all the compatibility quirks of running Resolve on Arch Linux — librar
- **OS**: [Omarchy](https://omarchy.com) (Arch Linux) - **OS**: [Omarchy](https://omarchy.com) (Arch Linux)
- **GPU**: NVIDIA with proprietary drivers installed and working - **GPU**: NVIDIA with proprietary drivers installed and working
- **Audio stack**: PipeWire + Wireplumber **0.5 or newer** (Omarchy default)
— the audio fix uses the SPA-JSON rule format introduced in 0.5
- **Kernel**: Stock Arch kernel (or any with `snd-aloop` available — verify
with `modinfo snd-aloop`)
- **Disk space**: ~10GB free in ~/Downloads for extraction (temporary) - **Disk space**: ~10GB free in ~/Downloads for extraction (temporary)
- **DaVinci Resolve ZIP**: Downloaded from Blackmagic's website - **DaVinci Resolve ZIP**: Downloaded from Blackmagic's website
@ -97,9 +101,12 @@ Resolve doesn't support native Wayland. The wrapper script (`resolve-nvidia-open
- Installs udev rules for Blackmagic hardware (capture cards, control panels) - Installs udev rules for Blackmagic hardware (capture cards, control panels)
- Points all launchers at the XWayland wrapper - Points all launchers at the XWayland wrapper
### 7. Audio Backend Fix (DeckLink → ALSA + `snd-aloop`) ### 7. Audio Backend Fix (DeckLink → ALSA + `snd-aloop` + Wireplumber rule)
Two issues are fixed automatically: Three pieces are needed for Resolve audio to actually work — all three are
applied automatically. Skipping any one of them leaves a different failure
mode visible (Resolve aborts on first launch / renders hang forever / monitor
audio loops onto itself).
**Default audio backend.** Resolve's shipped `default-config.dat` sets **Default audio backend.** Resolve's shipped `default-config.dat` sets
`Local.Audio.Type = DeckLink`, which causes Resolve to abort on first launch `Local.Audio.Type = DeckLink`, which causes Resolve to abort on first launch