vbifonixor · July 18, 2026 11:32
diff --git a/context.md b/context.md
diff --git a/general-concept.md b/general-concept.md
diff --git a/how-i-did-it.md b/how-i-did-it.md
diff --git a/remote-thor.sh b/remote-thor.sh
 #!/bin/bash

 set -Eeuo pipefail

 APP_NAME="remote-thor"
 APP_DIR="/roms/ports/$APP_NAME"
 LOG_FILE="$APP_DIR/log.txt"
 UNIT_NAME="$APP_NAME"
 SCRIPT_PATH="$(readlink -f "$0")"

 mkdir -p "$APP_DIR"

 # Relaunch independently from EmulationStation or the SSH session.
 if [ "${ANBERNIC_COMPANION_RUNNER:-0}" != "1" ]; then
    if sudo systemctl is-active --quiet "${UNIT_NAME}.service"; then
        exit 0
    fi

    sudo systemd-run \
        --unit="$UNIT_NAME" \
        --collect \
        --property=Type=exec \
        /usr/bin/env ANBERNIC_COMPANION_RUNNER=1 \
        /bin/bash "$SCRIPT_PATH"

    exit 0
 fi

 exec > >(tee "$LOG_FILE") 2>&1

 ADB="/usr/bin/adb"
 SCRCPY="/usr/bin/scrcpy"

 SCRCPY_PID=""
 WATCHER_PID=""
 THOR_SERIAL=""

 cleanup() {
    trap - EXIT INT TERM

    if [ -n "$WATCHER_PID" ]; then
        kill "$WATCHER_PID" 2>/dev/null || true
    fi

    if [ -n "$SCRCPY_PID" ]; then
        kill "$SCRCPY_PID" 2>/dev/null || true
    fi

    if [ -n "$THOR_SERIAL" ]; then
        "$ADB" disconnect "$THOR_SERIAL" >/dev/null 2>&1 || true
    fi

    systemctl start emulationstation >/dev/null 2>&1 || true
 }

 trap cleanup EXIT INT TERM

 echo "Starting Anbernic Companion: $(date)"

 systemctl stop emulationstation
 sleep 1

 "$ADB" start-server >/dev/null

 # The Android device is the hotspot gateway.
 THOR_IP="$(ip route | awk '/default/ {print $3; exit}')"

 if [ -z "$THOR_IP" ]; then
    echo "Thor hotspot gateway not found."
    sleep 5
    exit 1
 fi

 THOR_SERIAL="$THOR_IP:5555"

 echo "Connecting to Thor at $THOR_SERIAL"
 "$ADB" connect "$THOR_SERIAL" || true

 CONNECTED=0

 for _ in $(seq 1 10); do
    if [ "$("$ADB" -s "$THOR_SERIAL" get-state 2>/dev/null || true)" = "device" ]; then
        CONNECTED=1
        break
    fi

    sleep 0.5
 done

 if [ "$CONNECTED" -ne 1 ]; then
    echo "Thor did not accept the ADB connection."
    echo "Make sure ADB TCP port 5555 is enabled."
    sleep 5
    exit 1
 fi

 INPUT_DEVICE=""

 for event_path in /sys/class/input/event*; do
    [ -e "$event_path" ] || continue

    device_name="$(cat "$event_path/device/name" 2>/dev/null || true)"

    case "$device_name" in
        *retrogame_joypad*|*retrogame*joypad*)
            INPUT_DEVICE="/dev/input/$(basename "$event_path")"
            break
            ;;
    esac
 done

 if [ -z "$INPUT_DEVICE" ]; then
    echo "The Anbernic controller was not found."
    exit 1
 fi

 echo "Controller: $INPUT_DEVICE"

 env \
    SDL_VIDEODRIVER=kmsdrm \
    "$SCRCPY" \
        --serial "$THOR_SERIAL" \
        --fullscreen \
        --max-size=640 \
        --max-fps=60 \
        --video-codec=h264 \
        --video-bit-rate=2M \
        --no-audio \
        --mouse=disabled \
        --keyboard=disabled \
        --gamepad=uhid \
        --render-driver=opengles2 \
        --print-fps &

 SCRCPY_PID=$!

 # Close scrcpy when Start and Select are pressed together.
 python3 - "$INPUT_DEVICE" "$SCRCPY_PID" <<'PY' &
 import os
 import signal
 import struct
 import sys

 device = sys.argv[1]
 scrcpy_pid = int(sys.argv[2])

 EV_KEY = 1
 BTN_SELECT = 0x13A
 BTN_START = 0x13B

 event_struct = struct.Struct("llHHi")

 pressed = {
    BTN_SELECT: False,
    BTN_START: False,
 }

 with open(device, "rb", buffering=0) as controller:
    while True:
        data = controller.read(event_struct.size)

        if len(data) != event_struct.size:
            continue

        _, _, event_type, code, value = event_struct.unpack(data)

        if event_type != EV_KEY or code not in pressed:
            continue

        pressed[code] = value != 0

        if pressed[BTN_SELECT] and pressed[BTN_START]:
            try:
                os.kill(scrcpy_pid, signal.SIGTERM)
            except ProcessLookupError:
                pass

            break
 PY

 WATCHER_PID=$!

 if wait "$SCRCPY_PID"; then
    RESULT=0
 else
    RESULT=$?
 fi

 echo "scrcpy exited with status $RESULT"
 exit "$RESULT"
	#!/bin/bash

	set -Eeuo pipefail

	APP_NAME="remote-thor"
	APP_DIR="/roms/ports/$APP_NAME"
	LOG_FILE="$APP_DIR/log.txt"
	UNIT_NAME="$APP_NAME"
	SCRIPT_PATH="$(readlink -f "$0")"

	mkdir -p "$APP_DIR"

	# Relaunch independently from EmulationStation or the SSH session.
	if [ "${ANBERNIC_COMPANION_RUNNER:-0}" != "1" ]; then
	if sudo systemctl is-active --quiet "${UNIT_NAME}.service"; then
	exit 0
	fi

	sudo systemd-run \
	--unit="$UNIT_NAME" \
	--collect \
	--property=Type=exec \
	/usr/bin/env ANBERNIC_COMPANION_RUNNER=1 \
	/bin/bash "$SCRIPT_PATH"

	exit 0
	fi

	exec > >(tee "$LOG_FILE") 2>&1

	ADB="/usr/bin/adb"
	SCRCPY="/usr/bin/scrcpy"

	SCRCPY_PID=""
	WATCHER_PID=""
	THOR_SERIAL=""

	cleanup() {
	trap - EXIT INT TERM

	if [ -n "$WATCHER_PID" ]; then
	kill "$WATCHER_PID" 2>/dev/null \|\| true
	fi

	if [ -n "$SCRCPY_PID" ]; then
	kill "$SCRCPY_PID" 2>/dev/null \|\| true
	fi

	if [ -n "$THOR_SERIAL" ]; then
	"$ADB" disconnect "$THOR_SERIAL" >/dev/null 2>&1 \|\| true
	fi

	systemctl start emulationstation >/dev/null 2>&1 \|\| true
	}

	trap cleanup EXIT INT TERM

	echo "Starting Anbernic Companion: $(date)"

	systemctl stop emulationstation
	sleep 1

	"$ADB" start-server >/dev/null

	# The Android device is the hotspot gateway.
	THOR_IP="$(ip route \| awk '/default/ {print $3; exit}')"

	if [ -z "$THOR_IP" ]; then
	echo "Thor hotspot gateway not found."
	sleep 5
	exit 1
	fi

	THOR_SERIAL="$THOR_IP:5555"

	echo "Connecting to Thor at $THOR_SERIAL"
	"$ADB" connect "$THOR_SERIAL" \|\| true

	CONNECTED=0

	for _ in $(seq 1 10); do
	if [ "$("$ADB" -s "$THOR_SERIAL" get-state 2>/dev/null \|\| true)" = "device" ]; then
	CONNECTED=1
	break
	fi

	sleep 0.5
	done

	if [ "$CONNECTED" -ne 1 ]; then
	echo "Thor did not accept the ADB connection."
	echo "Make sure ADB TCP port 5555 is enabled."
	sleep 5
	exit 1
	fi

	INPUT_DEVICE=""

	for event_path in /sys/class/input/event*; do
	[ -e "$event_path" ] \|\| continue

	device_name="$(cat "$event_path/device/name" 2>/dev/null \|\| true)"

	case "$device_name" in
	retrogame_joypad\|retrogamejoypad*)
	INPUT_DEVICE="/dev/input/$(basename "$event_path")"
	break
	;;
	esac
	done

	if [ -z "$INPUT_DEVICE" ]; then
	echo "The Anbernic controller was not found."
	exit 1
	fi

	echo "Controller: $INPUT_DEVICE"

	env \
	SDL_VIDEODRIVER=kmsdrm \
	"$SCRCPY" \
	--serial "$THOR_SERIAL" \
	--fullscreen \
	--max-size=640 \
	--max-fps=60 \
	--video-codec=h264 \
	--video-bit-rate=2M \
	--no-audio \
	--mouse=disabled \
	--keyboard=disabled \
	--gamepad=uhid \
	--render-driver=opengles2 \
	--print-fps &

	SCRCPY_PID=$!

	# Close scrcpy when Start and Select are pressed together.
	python3 - "$INPUT_DEVICE" "$SCRCPY_PID" <<'PY' &
	import os
	import signal
	import struct
	import sys

	device = sys.argv[1]
	scrcpy_pid = int(sys.argv[2])

	EV_KEY = 1
	BTN_SELECT = 0x13A
	BTN_START = 0x13B

	event_struct = struct.Struct("llHHi")

	pressed = {
	BTN_SELECT: False,
	BTN_START: False,
	}

	with open(device, "rb", buffering=0) as controller:
	while True:
	data = controller.read(event_struct.size)

	if len(data) != event_struct.size:
	continue

	_, _, event_type, code, value = event_struct.unpack(data)

	if event_type != EV_KEY or code not in pressed:
	continue

	pressed[code] = value != 0

	if pressed[BTN_SELECT] and pressed[BTN_START]:
	try:
	os.kill(scrcpy_pid, signal.SIGTERM)
	except ProcessLookupError:
	pass

	break
	PY

	WATCHER_PID=$!

	if wait "$SCRCPY_PID"; then
	RESULT=0
	else
	RESULT=$?
	fi

	echo "scrcpy exited with status $RESULT"
	exit "$RESULT"
No results found