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
@@ -130,6 +130,19 @@ if [[ ! -s "$DB" && -s "$SELF_DIR/kde-authorized" ]]; then
    echo "seeded RemoteDesktop grant: $DB"
 fi

+# Virtual "Punktfunk" speaker: a null sink (shipped next to this script) that the host captures +
+# streams, set default so desktop audio goes there instead of a real/AirPlay device — a headless
+# host has no speakers, and on a LAN with AirPlay gear PipeWire otherwise picks a random HomePod.
+# pipewire reads its own config at start, so on FIRST install (config not yet present) restart it
+# once to load the sink; later boots already have it. (Also disable AirPlay discovery out of band:
+# `sudo dnf remove pipewire-config-raop`.)
+PWSINK="$HOME/.config/pipewire/pipewire.conf.d/50-punktfunk-sink.conf"
+if [[ ! -s "$PWSINK" && -s "$SELF_DIR/punktfunk-sink.conf" ]]; then
+    mkdir -p "$(dirname "$PWSINK")" && cp "$SELF_DIR/punktfunk-sink.conf" "$PWSINK"
+    echo "installed Punktfunk virtual speaker → restarting pipewire to load it"
+    systemctl --user restart pipewire 2>/dev/null || true
+fi
+
 # Reach graphical-session.target so xdg-desktop-portal (which is ordered After / fails its start
 # job without it) can come up — a headless linger session never gets there on its own, and Fedora's
 # target carries RefuseManualStart=yes, so drop that in once. Without the portal, libei input fails.