Levi Woodard
16e2465cf5
This bundles every fix we made debugging the first real install plus a comprehensive troubleshooting reference. Working tree is now PII-safe for public distribution: hostname-based default mode is driven by a HEADLESS_HOSTS env var instead of a hardcoded literal; docs use placeholders for hostnames and LAN IPs. Self-healing headless management - bin/sunshine-prestart.sh (new): runs as systemd ExecStartPre. Resolves the Hyprland instance signature from XDG_RUNTIME_DIR/hypr when systemd-user env didn't propagate it. Reduces to exactly one headless output by keeping the lowest-numbered HEADLESS-N and removing the rest. Rewrites the managed sunshine.conf's output_name line to match the surviving name — Hyprland's HEADLESS-N counter is monotonic and ignores the optional name argument to 'output create headless', so without active sync output_name drifts off HEADLESS-1 after the first restart cycle. - bin/sunshine-stream-do.sh: dropped the hardcoded MON=HEADLESS-1. Now discovers whatever HEADLESS-* exists via jq. Resize and workspace migration target the actual output. - bin/sunshine-stream-undo.sh: reads the headless name from a state file the do-script wrote, with discovery fallback. Stops removing the output between sessions — the create/destroy race caused fatal startup encoder errors on the next Sunshine restart. - files/headless-prestart.conf, files/sunshine.service: ExecStartPre now points at the new prestart script. - lib/headless.sh: install_headless_hooks now installs all three scripts. New install_headless_prestart_dropin resolves the actual systemd unit name (sunshine.service vs app-dev.lizardbyte.app.Sunshine.service) and lands the drop-in under <unit>.service.d/. Firewall detection - lib/firewall.sh: _ufw_active now uses 'systemctl is-active ufw.service' instead of 'ufw status'. The latter requires root to read /etc/ufw state, so the unprivileged probe returned false and we silently skipped opening Sunshine's ports on hosts where ufw was actively dropping packets. Service unit fallbacks - lib/service.sh: ensure_sunshine_unit_present looks for sunshine.service in every systemd-user path first; falls back to the reverse-DNS AUR-source unit name; last resort drops a repo-provided fallback unit. systemctl reset-failed before each restart so a previous start-limit-hit doesn't immediately reject the new attempt. Preflight - lib/preflight.sh: new preflight_headless step that, only when STREAM_MODE is headless, surfaces missing hyprctl / jq / Hyprland reachability before install proceeds. Public-safe defaults - install.sh: streaming-mode default is now driven by HEADLESS_HOSTS env var (comma-separated, case-insensitive). Unset by default — every host gets mirror mode unless its hostname is listed or --headless is passed explicitly. Past versions hardcoded a specific hostname. - README.md: replaced JARVIS-specific examples with HEADLESS_HOSTS prose. Docs - docs/TROUBLESHOOTING.md (new): comprehensive failure-mode reference. Every issue hit during the first end-to-end install, in order, with symptom → cause → fix → permanent prevention. Plus a "Custom keybinding to escape Moonlight" section and an outstanding-followups punch list (1Password black-rectangle workarounds, hypridle inhibit during stream, busiest- workspace auto-switch, jarvis.lan DNS, 1Password SSH agent timeouts).
55 lines
2.3 KiB
Bash
55 lines
2.3 KiB
Bash
#!/usr/bin/env bash
|
|
# Set up headless streaming mode: install prep-cmd hook scripts into a stable
|
|
# location and ensure they're executable. The actual sunshine.conf entries
|
|
# (capture=wlr, output_name=HEADLESS-1, global_prep_cmd=[...]) are written
|
|
# by lib/config.sh.
|
|
|
|
HEADLESS_BIN_DIR="$HOME/.local/share/omarchy-moonlight/bin"
|
|
|
|
DO_SCRIPT="$HEADLESS_BIN_DIR/sunshine-stream-do.sh"
|
|
UNDO_SCRIPT="$HEADLESS_BIN_DIR/sunshine-stream-undo.sh"
|
|
export DO_SCRIPT UNDO_SCRIPT
|
|
|
|
install_headless_hooks() {
|
|
# Install hook scripts to ~/.local/share so they don't disappear if the
|
|
# repo gets moved or deleted. Sunshine's config will reference these stable paths.
|
|
mkdir -p "$HEADLESS_BIN_DIR"
|
|
install -m 0755 "$SCRIPT_DIR/bin/sunshine-stream-do.sh" "$DO_SCRIPT"
|
|
install -m 0755 "$SCRIPT_DIR/bin/sunshine-stream-undo.sh" "$UNDO_SCRIPT"
|
|
install -m 0755 "$SCRIPT_DIR/bin/sunshine-prestart.sh" "$HEADLESS_BIN_DIR/sunshine-prestart.sh"
|
|
ok "Installed prep-cmd + prestart hooks to $HEADLESS_BIN_DIR"
|
|
}
|
|
|
|
# Install a systemd-user drop-in that pre-creates HEADLESS-1 before Sunshine
|
|
# starts, so the encoder probe at startup sees a valid Wayland output. Without
|
|
# this, Sunshine reports a fatal "Unable to find display or encoder during
|
|
# startup" on every restart, even though streaming works once a client connects.
|
|
install_headless_prestart_dropin() {
|
|
local dropin_src="$SCRIPT_DIR/files/headless-prestart.conf"
|
|
if [[ ! -f "$dropin_src" ]]; then
|
|
err "Drop-in source missing: $dropin_src"
|
|
return 1
|
|
fi
|
|
|
|
# Resolve the actual unit name. Prefer sunshine.service when present (alias
|
|
# or sunshine-bin); fall back to the AUR source pkg's reverse-DNS name.
|
|
local unit=""
|
|
for u in sunshine.service app-dev.lizardbyte.app.Sunshine.service; do
|
|
if systemctl --user list-unit-files "$u" >/dev/null 2>&1 \
|
|
&& systemctl --user cat "$u" >/dev/null 2>&1; then
|
|
unit="$u"
|
|
break
|
|
fi
|
|
done
|
|
if [[ -z "$unit" ]]; then
|
|
warn "Could not resolve a sunshine unit to attach the drop-in to; skipping."
|
|
return 0
|
|
fi
|
|
|
|
local dropin_dir="$HOME/.config/systemd/user/${unit}.d"
|
|
mkdir -p "$dropin_dir"
|
|
install -m 0644 "$dropin_src" "$dropin_dir/headless-prestart.conf"
|
|
systemctl --user daemon-reload
|
|
ok "Installed headless prestart drop-in at $dropin_dir/headless-prestart.conf"
|
|
}
|