fix(headless/kde): virtual Punktfunk speaker + restart host with the session

Audio: a headless host has no speakers, and on a LAN with AirPlay devices PipeWire picks a random HomePod as default — so desktop audio (which the host captures from the default sink's monitor) went to a HomePod over AirPlay instead of to the client, and there was no "Punktfunk" output to select. Ship a `punktfunk-sink.conf` (a `support.null-audio-sink` adapter — NOT the non-existent module-null-sink, which makes pipewire refuse to start) with high priority.session so it's the default; run-headless-kde.sh installs it and restarts pipewire once on first install. The host then captures its monitor and streams it. (Disable AirPlay sinks out of band: `dnf remove pipewire-config-raop`.) Input: the host's libei portal D-Bus connection goes stale when the compositor session restarts the portal under it, and the in-process reopen loop can't recover it (EIS setup keeps timing out) — only a full restart does. Add PartOf=punktfunk-kde-session.service so the host restarts with the session. Both verified live on the Fedora 44 KDE box. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-13 23:30:36 +00:00
parent 9c23ad5303
commit 5bc257f1ae
5 changed files with 48 additions and 0 deletions
@@ -0,0 +1,26 @@
+# PipeWire drop-in for the headless punktfunk host: a virtual "Punktfunk" speaker.
+#
+# A headless streaming host has no real speakers — desktop audio should go to a sink the host
+# captures and streams to the client, not to whatever PipeWire picked (on a LAN with AirPlay
+# devices that's often a random HomePod). This null sink is that capture target; its high
+# priority.session makes WirePlumber select it as the default output, so apps play to it, the host
+# captures its monitor (audio/linux.rs, stream.capture.sink), and the client hears the desktop.
+#
+# Copied to ~/.config/pipewire/pipewire.conf.d/ by run-headless-kde.sh. Pair with disabling RAOP
+# (remove the pipewire-config-raop package / its 50-raop.conf symlink) so AirPlay devices don't
+# show up as outputs at all. NB: a null sink is a `support.null-audio-sink` adapter object — NOT
+# `libpipewire-module-null-sink`, which doesn't exist on PipeWire 1.x and makes the daemon refuse
+# to start (mandatory-module load failure).
+context.objects = [
+    {   factory = adapter
+        args = {
+            factory.name     = support.null-audio-sink
+            node.name        = "punktfunk"
+            node.description  = "Punktfunk"
+            media.class      = "Audio/Sink"
+            object.linger    = true
+            audio.position   = [ FL FR ]
+            priority.session = 2000
+        }
+    }
+]