Files
Omarchy-Stream/lib/verify.sh
Levi Woodard 171ade4ff1 Add headless streaming mode + Mac client + full docs
Headless mode (new) — for KVM-attached hosts streaming to disconnected clients
- --headless / --mirror flags; default headless on hostname JARVIS, mirror elsewhere
- New lib/headless.sh installs prep-cmd hooks to ~/.local/share/omarchy-moonlight/bin
- bin/sunshine-stream-do.sh creates/resizes a Hyprland HEADLESS-1 output to the
  connecting client's resolution and migrates the active workspace onto it
- bin/sunshine-stream-undo.sh tears down the headless output on disconnect and
  returns the workspace to a non-headless monitor when one is available
- lib/config.sh writes capture=wlr, output_name=HEADLESS-1, and the JSON
  global_prep_cmd entry referencing the installed hook paths
- lib/preflight.sh adds a preflight_headless step that checks hyprctl, jq, and
  a running Hyprland session (warn-only, install can proceed)
- lib/verify.sh adds checks for the hook scripts and the wlr/global_prep_cmd
  config lines

Mac client
- client/install-macos.sh: Darwin guard, Homebrew presence check, brew cask
  install of Moonlight, idempotent
- client/README.md: per-platform install (macOS / Android / iOS / Apple TV /
  Linux + Steam Deck) and the five-step first-pair walkthrough

Other
- jq added to the helper install set in lib/packages.sh (hooks parse Hyprland
  JSON output)
- README.md rewritten to cover both modes, the new flags, the tuned defaults
  per mode + per vendor, the headless internals, and the client pointer
2026-05-18 10:31:08 -06:00

122 lines
3.8 KiB
Bash

#!/usr/bin/env bash
# Post-install verification — confirm each piece is actually wired up.
# Prints a checklist; non-fatal so the user sees the whole picture.
VERIFY_FAILURES=0
_check() {
local name="$1"; shift
if "$@" >/dev/null 2>&1; then
ok "$name"
else
err "$name"
VERIFY_FAILURES=$((VERIFY_FAILURES + 1))
fi
}
verify_install() {
step "Verifying install"
_check "sunshine binary on PATH" command -v sunshine
local bin
bin="$(command -v sunshine 2>/dev/null || true)"
if [[ -n "$bin" ]]; then
bin="$(readlink -f "$bin")"
if getcap "$bin" 2>/dev/null | grep -q cap_sys_admin; then
ok "sunshine has cap_sys_admin (KMS capture ready)"
else
err "sunshine missing cap_sys_admin — KMS capture will fail"
VERIFY_FAILURES=$((VERIFY_FAILURES + 1))
fi
fi
if id -nG "$USER" | tr ' ' '\n' | grep -qx input; then
ok "user '$USER' resolves with 'input' group in current shell"
else
warn "user '$USER' is NOT in 'input' group in this shell session."
warn " /etc/group is correct; you need to log out + back in (or 'newgrp input')."
fi
if grep -rqs 'KERNEL=="uinput"' /etc/udev/rules.d /usr/lib/udev/rules.d /run/udev/rules.d 2>/dev/null; then
ok "uinput udev rule present"
else
err "uinput udev rule missing"
VERIFY_FAILURES=$((VERIFY_FAILURES + 1))
fi
if [[ -c /dev/uinput ]]; then
ok "/dev/uinput exists"
else
warn "/dev/uinput not present yet — may appear on next reboot or 'modprobe uinput'"
fi
case "$GPU_VENDOR" in
nvidia)
if nvidia-smi --query-gpu=encoder.stats.sessionCount --format=csv,noheader >/dev/null 2>&1; then
ok "NVENC interface reachable via nvidia-smi"
else
warn "Could not query NVENC via nvidia-smi (driver may need a reboot after install)"
fi
;;
amd)
if command -v vainfo >/dev/null 2>&1 && vainfo 2>/dev/null | grep -qi 'VAEntrypointEncSlice\|VAProfileH264'; then
ok "VAAPI encoder profiles available"
else
warn "VAAPI encoder profiles not confirmed (install libva-utils to verify with 'vainfo')"
fi
;;
esac
if [[ "${STREAM_MODE:-}" == "headless" ]]; then
local do_script="$HOME/.local/share/omarchy-moonlight/bin/sunshine-stream-do.sh"
local undo_script="$HOME/.local/share/omarchy-moonlight/bin/sunshine-stream-undo.sh"
local conf="$HOME/.config/sunshine/sunshine.conf"
if [[ -x "$do_script" ]]; then
ok "headless do-hook present and executable"
else
err "headless do-hook missing or not executable: $do_script"
VERIFY_FAILURES=$((VERIFY_FAILURES + 1))
fi
if [[ -x "$undo_script" ]]; then
ok "headless undo-hook present and executable"
else
err "headless undo-hook missing or not executable: $undo_script"
VERIFY_FAILURES=$((VERIFY_FAILURES + 1))
fi
if [[ -f "$conf" ]] && grep -q '^capture = wlr' "$conf"; then
ok "sunshine.conf has capture = wlr"
else
err "sunshine.conf missing 'capture = wlr'"
VERIFY_FAILURES=$((VERIFY_FAILURES + 1))
fi
if [[ -f "$conf" ]] && grep -q '^global_prep_cmd' "$conf"; then
ok "sunshine.conf has global_prep_cmd"
else
err "sunshine.conf missing 'global_prep_cmd'"
VERIFY_FAILURES=$((VERIFY_FAILURES + 1))
fi
fi
if systemctl --user is-active --quiet sunshine.service; then
ok "sunshine.service is active"
if ss -ltn 2>/dev/null | grep -q ':47990 '; then
ok "web UI listening on :47990"
else
warn "web UI port 47990 not yet listening (service may still be starting)"
fi
else
warn "sunshine.service is not active"
warn " Inspect: journalctl --user -u sunshine -n 50 --no-pager"
fi
if [[ $VERIFY_FAILURES -gt 0 ]]; then
warn "$VERIFY_FAILURES check(s) failed — see ${BOLD}README.md${RESET}${YELLOW} 'Diagnostics' for fixes."
else
ok "All checks passed."
fi
}