OpenPuck/ReversePuck/ReversePuck

#!/usr/bin/env bash
# ReversePuck Steam Deck forwarder launcher (uv-based; nothing installed system-wide).
#
# Add as a NON-STEAM GAME:
#   Target:      /home/deck/…/ReversePuck/ReversePuck
#   Start In:    /home/deck/…/ReversePuck/    (the directory this script is in)
# Then, in that shortcut's gear -> Properties -> Controller, set "Disable Steam Input" so Steam doesn't
# fight us for the built-in pad while we grab it.
#
# Dependencies are pulled by uv on first run (pyserial + pygame + pyusb -- prebuilt wheels; pyusb uses
# the system libusb-1.0.so). uv also provisions its own Python, so nothing touches the read-only rootfs.
#
# USB-level detach (DeckSource) needs access to the controller's usbfs node, and the CDC link needs
# /dev/ttyACM*. Run `sudo ./setup.sh` once per boot to open both (see README). Without it, fall back to
# `./ReversePuck --evdev` (no USB detach; Steam/QAM won't forward, trackpads are lower fidelity).
set -euo pipefail
cd "$(dirname "$(readlink -f "$0")")"

find_uv() {
	local uv
	uv="$(command -v uv || true)"
	[ -n "$uv" ] || { [ -x "$HOME/.local/bin/uv" ] && uv="$HOME/.local/bin/uv"; }
	[ -x "$uv" ] && { printf '%s' "$uv"; return 0; }
	return 1
}

UV="$(find_uv || true)"
if [ -z "$UV" ]; then
	# Bootstrap uv on first run. SteamOS' rootfs is read-only, but the official installer drops a
	# self-contained binary under ~/.local/bin (writable), so nothing touches the system.
	echo "uv not found — installing it (one-time) via https://astral.sh/uv …"
	if command -v curl >/dev/null 2>&1; then
		curl -LsSf https://astral.sh/uv/install.sh | sh
	elif command -v wget >/dev/null 2>&1; then
		wget -qO- https://astral.sh/uv/install.sh | sh
	else
		echo "Cannot bootstrap uv: neither curl nor wget is available." >&2
		echo "Install uv manually: https://docs.astral.sh/uv/" >&2
		exit 1
	fi
	UV="$(find_uv || true)"
	[ -n "$UV" ] || { echo "uv install completed but the binary was not found on PATH or in ~/.local/bin." >&2; exit 1; }
	echo "uv installed: $UV"
fi

exec "$UV" run --with pyserial --with pygame --with pyusb python openctrl.py "$@"