Miyoo Flip: Up-to-date with main

.gitignore

@@ -41,3 +41,8 @@ audiomon.elf
 
 workspace/hash.txt
 workspace/readmes
+workspace/.container_runtime
+
+AGENTS.md
+CLAUDE.md
+.worktrees/

HOOKS.md

@@ -0,0 +1,87 @@
+# About NextUI hooks
+
+## The idea
+
+Hooks are platform-specific, just like paks. The launcher reads them from:
+
+```
+$USERDATA_PATH/.hooks/
+    boot.d/          # scripts run on boot
+    pre-launch.d/    # scripts run before launch
+    post-launch.d/   # scripts run after launch exits
+    pre-sleep.d/     # scripts run before device goes to sleep
+    post-resume.d/   # scripts run after device wakes from sleep
+```
+
+On device, `USERDATA_PATH` resolves to:
+
+```
+/mnt/SDCARD/.userdata/$PLATFORM
+```
+
+So the actual hook directories on device are:
+
+```
+/mnt/SDCARD/.userdata/<platform>/.hooks/pre-launch.d/
+/mnt/SDCARD/.userdata/<platform>/.hooks/post-launch.d/
+
+```
+
+Example installed hook path:
+
+```
+/mnt/SDCARD/.userdata/tg5040/.hooks/post-launch.d/shortcuts-resume.sh
+
+```
+
+If these directories don't exist, nothing happens and there is no overhead.
+
+## Environment variables
+
+Hook scripts inherit all standard NextUI environment variables (`SDCARD_PATH`, `PLATFORM`, `USERDATA_PATH`, `SHARED_USERDATA_PATH`, etc.) plus these launch-specific ones:
+
+| Variable | Description |
+|---|---|
+| `HOOK_PHASE` | `pre` or `post` |
+| `HOOK_TYPE` | `rom` or `pak` |
+| `HOOK_CMD` | The raw launch command |
+| `HOOK_EMU_PATH` | Path to the emulator or pak `launch.sh` |
+| `HOOK_ROM_PATH` | Path to the ROM file (empty for pak launches) |
+| `HOOK_LAST` | Contents of `/tmp/last.txt` (the last selected menu entry) |
+
+These can then be used by the underlying Pak to ingest information about the hook that just occurred.
+
+## Writing a hook script
+
+A hook script is any executable `.sh` file in one of the hook directories. Scripts run in alphabetical order.
+
+```sh
+#!/bin/sh
+# my-hook.sh — log every ROM launch
+
+[ "$HOOK_TYPE" = "rom" ] || exit 0
+echo "$(date): launched $HOOK_ROM_PATH" >> "$LOGS_PATH/launches.log"
+```
+
+## Rules
+
+- Each script runs in a subshell. A crash or non-zero exit will not affect the launcher or other hooks.
+- Script output (stdout/stderr) is suppressed. If you need logging, write to your own log file.
+- Pre-launch hooks cannot cancel the launch. They are for observation and setup only.
+- Keep hooks fast. A slow hook delays the launch or the return to the menu.
+- Unlike auto.sh, each pak should manage their own hook and use a descriptive filename to avoid collisions.
+
+
+## Example: sync after ROM exit
+
+```sh
+#!/bin/sh
+# shortcuts-resume.sh — one-shot resume metadata sync after a ROM exits
+
+[ "$HOOK_TYPE" = "rom" ] || exit 0
+
+SHORTCUTS_PAK="$SDCARD_PATH/Tools/$PLATFORM/Shortcuts.pak"
+[ -x "$SHORTCUTS_PAK/shortcuts" ] || exit 0
+
+"$SHORTCUTS_PAK/shortcuts" --resume-sync-hook >> "$LOGS_PATH/shortcuts-resume-sync.txt" 2>&1
+```

makefile

@@ -125,8 +125,9 @@ ifneq (,$(filter $(PLATFORM),tg5040 tg5050 my355))
 	cp ./workspace/all/minarch/build/$(PLATFORM)/liblzma.so.* ./build/SYSTEM/$(PLATFORM)/lib/
 	cp ./workspace/all/minarch/build/$(PLATFORM)/libzstd.so.* ./build/SYSTEM/$(PLATFORM)/lib/
 
-	# libchdr for RetroAchievements CHD hashing
+	# libchdr and libcrypto for RetroAchievements
 	cp ./workspace/all/minarch/build/$(PLATFORM)/libchdr.so.* ./build/SYSTEM/$(PLATFORM)/lib/
+	cp ./workspace/all/minarch/build/$(PLATFORM)/libcrypto.so.* ./build/SYSTEM/$(PLATFORM)/lib/
 
 ifneq (,$(filter $(PLATFORM),tg5040 my355))
 	# liblz4 for Rewind support

makefile.toolchain

@@ -1,6 +1,6 @@
 # there is no reason to use this makefile manually
 
-.PHONY: build clean
+.PHONY: build clean _runtime_check
 
 ifeq (,$(PLATFORM))
 $(error please specify PLATFORM, eg. make PLATFORM=trimui)
@@ -13,28 +13,54 @@ GIT_IF_NECESSARY=toolchains/$(PLATFORM)-toolchain
 INIT_IF_NECESSARY=toolchains/$(PLATFORM)-toolchain/.build
 IMAGE_NAME=ghcr.io/loveretro/$(PLATFORM)-toolchain:latest
 
+CONTAINER_RUNTIME ?= $(shell command -v docker 2>/dev/null || command -v podman 2>/dev/null)
+ifeq (,$(CONTAINER_RUNTIME))
+$(error Neither docker nor podman found in PATH)
+endif
+
+RUNTIME_MARKER := $(HOST_WORKSPACE)/.container_runtime
+LAST_RUNTIME := $(shell cat $(RUNTIME_MARKER) 2>/dev/null)
+CURRENT_RUNTIME := $(notdir $(CONTAINER_RUNTIME))
+
 all: $(INIT_IF_NECESSARY)
-	docker run -it --rm -v $(HOST_WORKSPACE):$(GUEST_WORKSPACE) $(IMAGE_NAME) /bin/bash
+	$(CONTAINER_RUNTIME) run -it --rm -v $(HOST_WORKSPACE):$(GUEST_WORKSPACE) $(IMAGE_NAME) /bin/bash
 
 $(INIT_IF_NECESSARY): $(GIT_IF_NECESSARY)
 	cd toolchains/$(PLATFORM)-toolchain && make .build
 
 $(GIT_IF_NECESSARY):
 	mkdir -p toolchains
 	git clone https://github.com/LoveRetro/$(PLATFORM)-toolchain/ toolchains/$(PLATFORM)-toolchain
-	docker pull $(IMAGE_NAME) && touch toolchains/$(PLATFORM)-toolchain/.build
+	$(CONTAINER_RUNTIME) pull $(IMAGE_NAME) && touch toolchains/$(PLATFORM)-toolchain/.build
 
 clean:
 	cd toolchains/$(PLATFORM)-toolchain && make clean
 
-build: $(INIT_IF_NECESSARY)
-	docker run --rm -v $(HOST_WORKSPACE):$(GUEST_WORKSPACE) -e COMPILE_CORES=$(COMPILE_CORES) $(IMAGE_NAME) /bin/bash -c '. ~/.bashrc && cd /root/workspace && make'
+_runtime_check:
+	@if [ -n "$(LAST_RUNTIME)" ] && [ "$(LAST_RUNTIME)" != "$(CURRENT_RUNTIME)" ]; then \
+		echo "Container runtime changed ($(LAST_RUNTIME) -> $(CURRENT_RUNTIME)), cleaning workspace build artifacts..."; \
+		PREV=$$(command -v $(LAST_RUNTIME) 2>/dev/null); \
+		if [ -n "$$PREV" ]; then \
+			$$PREV run --rm -v $(HOST_WORKSPACE):$(GUEST_WORKSPACE) $(IMAGE_NAME) /bin/bash -c \
+				'find $(GUEST_WORKSPACE) -depth -user root -delete 2>/dev/null; true'; \
+		else \
+			echo "Error: previous runtime $(LAST_RUNTIME) not available to clean root-owned artifacts."; \
+			echo "Run: sudo rm -rf $(HOST_WORKSPACE)/*/build $(HOST_WORKSPACE)/$(PLATFORM)/other"; \
+			exit 1; \
+		fi; \
+	fi
+
+build: $(INIT_IF_NECESSARY) _runtime_check
+	$(CONTAINER_RUNTIME) run --rm -v $(HOST_WORKSPACE):$(GUEST_WORKSPACE) -e COMPILE_CORES=$(COMPILE_CORES) $(IMAGE_NAME) /bin/bash -c '. ~/.bashrc && cd /root/workspace && make'
+	@echo "$(CURRENT_RUNTIME)" > $(RUNTIME_MARKER)
 
-build-cores: $(INIT_IF_NECESSARY)
-	docker run --rm -v $(HOST_WORKSPACE):$(GUEST_WORKSPACE) -e COMPILE_CORES=$(COMPILE_CORES) $(IMAGE_NAME) /bin/bash -c '. ~/.bashrc && cd /root/workspace && make cores'
+build-cores: $(INIT_IF_NECESSARY) _runtime_check
+	$(CONTAINER_RUNTIME) run --rm -v $(HOST_WORKSPACE):$(GUEST_WORKSPACE) -e COMPILE_CORES=$(COMPILE_CORES) $(IMAGE_NAME) /bin/bash -c '. ~/.bashrc && cd /root/workspace && make cores'
+	@echo "$(CURRENT_RUNTIME)" > $(RUNTIME_MARKER)
 
-build-core: $(INIT_IF_NECESSARY)
+build-core: $(INIT_IF_NECESSARY) _runtime_check
 ifndef CORE
 	$(error CORE is not set)
 endif
-	docker run --rm -v $(HOST_WORKSPACE):$(GUEST_WORKSPACE) -e COMPILE_CORES=$(COMPILE_CORES) -e CORE=$(CORE) $(IMAGE_NAME) /bin/bash -c '. ~/.bashrc && cd /root/workspace && make core'
+	$(CONTAINER_RUNTIME) run --rm -v $(HOST_WORKSPACE):$(GUEST_WORKSPACE) -e COMPILE_CORES=$(COMPILE_CORES) -e CORE=$(CORE) $(IMAGE_NAME) /bin/bash -c '. ~/.bashrc && cd /root/workspace && make core'
+	@echo "$(CURRENT_RUNTIME)" > $(RUNTIME_MARKER)

skeleton/SYSTEM/desktop/bin/run_hooks.sh

@@ -0,0 +1,36 @@
+#!/bin/sh
+# run_hooks.sh - shared hook runner for NextUI
+# Usage: run_hooks.sh <dir-name> [--sync-only]
+#
+# dir-name:   directory name under $USERDATA_PATH/.hooks/ (e.g. pre-launch.d, boot.d)
+# --sync-only: force all scripts to run synchronously
+#
+# By default, scripts run in the background. Scripts ending in .sync.sh
+# always run synchronously. All background scripts are waited on before exit.
+
+DIR_NAME="$1"
+SYNC_ONLY="${2:-}"
+
+: "${SDCARD_PATH:=/var/tmp/nextui/sdcard}"
+: "${PLATFORM:=desktop}"
+: "${USERDATA_PATH:=$SDCARD_PATH/.userdata/$PLATFORM}"
+
+HOOK_DIR="$USERDATA_PATH/.hooks/$DIR_NAME"
+[ -d "$HOOK_DIR" ] || exit 0
+
+case "$DIR_NAME" in
+	pre-*)  export HOOK_PHASE="pre" ;;
+	post-*) export HOOK_PHASE="post" ;;
+	boot*)  export HOOK_PHASE="boot" ;;
+esac
+export HOOK_CATEGORY="$DIR_NAME"
+
+for script in "$HOOK_DIR"/*.sh; do
+	[ -f "$script" ] || continue
+	if [ "$SYNC_ONLY" = "--sync-only" ] || echo "$script" | grep -q '\.sync\.sh$'; then
+		( "$script" ) > /dev/null 2>&1 || true
+	else
+		( "$script" ) > /dev/null 2>&1 &
+	fi
+done
+wait

skeleton/SYSTEM/desktop/paks/MinUI.pak/launch.sh

@@ -18,6 +18,7 @@ export CORES_PATH="$SYSTEM_PATH/cores"
 export USERDATA_PATH="$SDCARD_PATH/.userdata/$PLATFORM"
 export SHARED_USERDATA_PATH="$SDCARD_PATH/.userdata/shared"
 export LOGS_PATH="$USERDATA_PATH/logs"
+export HOOKS_PATH="$USERDATA_PATH/.hooks"
 export DATETIME_PATH="$SHARED_USERDATA_PATH/datetime.txt"
 
 mkdir -p "$BIOS_PATH"
@@ -26,6 +27,7 @@ mkdir -p "$SAVES_PATH"
 mkdir -p "$CHEATS_PATH"
 mkdir -p "$USERDATA_PATH"
 mkdir -p "$LOGS_PATH"
+mkdir -p "$HOOKS_PATH"
 mkdir -p "$SHARED_USERDATA_PATH/.minui"
 
 export IS_NEXT="yes"
@@ -45,8 +47,29 @@ if [ -f "$AUTO_PATH" ]; then
 	"$AUTO_PATH"
 fi
 
+# Composable boot hooks (run after auto.sh for backward compatibility)
+"$SYSTEM_PATH/bin/run_hooks.sh" boot.d
+
 cd $(dirname "$0")
 
+#######################################
+# Hook system
+
+parse_hook_cmd() {
+	HOOK_CMD="$1"
+	HOOK_EMU_PATH=$(echo "$HOOK_CMD" | sed "s/^'\\([^']*\\)'.*/\\1/")
+	_remainder=$(echo "$HOOK_CMD" | sed "s/^'[^']*'//")
+	if echo "$_remainder" | grep -q "'"; then
+		HOOK_TYPE="rom"
+		HOOK_ROM_PATH=$(echo "$_remainder" | sed "s/.*'\\([^']*\\)'.*/\\1/")
+	else
+		HOOK_TYPE="pak"
+		HOOK_ROM_PATH=""
+	fi
+	[ -f /tmp/last.txt ] && HOOK_LAST=$(cat /tmp/last.txt) || HOOK_LAST=""
+	export HOOK_CMD HOOK_EMU_PATH HOOK_TYPE HOOK_ROM_PATH HOOK_LAST
+}
+
 #######################################
 
 EXEC_PATH="/tmp/nextui_exec"
@@ -57,7 +80,10 @@ touch "$EXEC_PATH"  && sync
 
 	if [ -f $NEXT_PATH ]; then
 		CMD=`cat $NEXT_PATH`
+		parse_hook_cmd "$CMD"
+		"$SYSTEM_PATH/bin/run_hooks.sh" pre-launch.d
 		eval $CMD
+		"$SYSTEM_PATH/bin/run_hooks.sh" post-launch.d
 		rm -f $NEXT_PATH
 	fi
 #done

skeleton/SYSTEM/my355/bin/governor.sh

@@ -0,0 +1,58 @@
+#!/bin/sh
+# governor.sh - CPU governor controller for MY355
+# Usage: governor.sh <mode>
+# Modes: auto, performance, powersave
+
+MODE="$1"
+[ -z "$MODE" ] && MODE="auto"
+
+set_policy() {
+        local policy_path="$1"
+        local governor="$2"
+        local max_type="$3"  # "second_max", "max", or "mid"
+
+        [ -f "$policy_path/scaling_available_frequencies" ] || return 0
+        FREQS=$(cat "$policy_path/scaling_available_frequencies" | tr ' ' '\n' | grep -v '^$' | sort -n)
+        MIN_FREQ=$(echo "$FREQS" | head -1)
+
+        case "$max_type" in
+                second_max)
+                        MAX_FREQ=$(echo "$FREQS" | tail -2 | head -1)
+                        ;;
+                max)
+                        MAX_FREQ=$(echo "$FREQS" | tail -1)
+                        ;;
+                mid)
+                        COUNT=$(echo "$FREQS" | wc -l)
+                        MID=$(( (COUNT + 1) / 2 ))
+                        MAX_FREQ=$(echo "$FREQS" | sed -n "${MID}p")
+                        ;;
+                *)
+                        MAX_FREQ=$(echo "$FREQS" | tail -1)
+                        ;;
+        esac
+
+        echo "$governor" > "$policy_path/scaling_governor" 2>/dev/null || true
+        echo "$MIN_FREQ" > "$policy_path/scaling_min_freq"
+        echo "$MAX_FREQ" > "$policy_path/scaling_max_freq"
+}
+
+case "$MODE" in
+        auto)
+                # schedutil governor, min freq to one step below max (408-1800 MHz on MY355)
+                set_policy /sys/devices/system/cpu/cpufreq/policy0 "schedutil" "second_max"
+                ;;
+        performance)
+                # performance governor, max freq (1992 MHz on MY355)
+                set_policy /sys/devices/system/cpu/cpufreq/policy0 "performance" "max"
+                ;;
+        powersave)
+                # conservative governor, min freq to midpoint max (408-1200 MHz on MY355)
+                set_policy /sys/devices/system/cpu/cpufreq/policy0 "conservative" "mid"
+                ;;
+        *)
+                echo "governor.sh: unknown mode '$MODE'" >&2
+                echo "  Valid modes: auto, performance, powersave" >&2
+                exit 1
+                ;;
+esac

skeleton/SYSTEM/my355/bin/run_hooks.sh

@@ -0,0 +1,36 @@
+#!/bin/sh
+# run_hooks.sh - shared hook runner for NextUI
+# Usage: run_hooks.sh <dir-name> [--sync-only]
+#
+# dir-name:   directory name under $USERDATA_PATH/.hooks/ (e.g. pre-launch.d, boot.d)
+# --sync-only: force all scripts to run synchronously
+#
+# By default, scripts run in the background. Scripts ending in .sync.sh
+# always run synchronously. All background scripts are waited on before exit.
+
+DIR_NAME="$1"
+SYNC_ONLY="${2:-}"
+
+: "${SDCARD_PATH:=/mnt/SDCARD}"
+: "${PLATFORM:=my355}"
+: "${USERDATA_PATH:=$SDCARD_PATH/.userdata/$PLATFORM}"
+
+HOOK_DIR="$USERDATA_PATH/.hooks/$DIR_NAME"
+[ -d "$HOOK_DIR" ] || exit 0
+
+case "$DIR_NAME" in
+	pre-*)  export HOOK_PHASE="pre" ;;
+	post-*) export HOOK_PHASE="post" ;;
+	boot*)  export HOOK_PHASE="boot" ;;
+esac
+export HOOK_CATEGORY="$DIR_NAME"
+
+for script in "$HOOK_DIR"/*.sh; do
+	[ -f "$script" ] || continue
+	if [ "$SYNC_ONLY" = "--sync-only" ] || echo "$script" | grep -q '\.sync\.sh$'; then
+		( "$script" ) > /dev/null 2>&1 || true
+	else
+		( "$script" ) > /dev/null 2>&1 &
+	fi
+done
+wait

skeleton/SYSTEM/my355/bin/suspend

@@ -21,6 +21,10 @@ fix_sleep_sound_bug() {
 before() {
     log "Preparing for suspend..."
 
+    # Run pre-sleep hooks synchronously before services are stopped.
+	# Subshell ensures a crashing hook cannot block suspend.
+	( "$SYSTEM_PATH/bin/run_hooks.sh" pre-sleep.d --sync-only ) >/dev/null 2>&1 || true
+
     # Probably not necessary and dangerous actually
     # log "Turning off input"
     # echo 0 > /sys/module/gpio_keys_polled/parameters/button_enable
@@ -35,6 +39,9 @@ after() {
     # log "Turning on input"
     # echo 1 > /sys/module/gpio_keys_polled/parameters/button_enable
 
+    # Run post-resume hooks in background immediately after wake.
+	( "$SYSTEM_PATH/bin/run_hooks.sh" post-resume.d ) >/dev/null 2>&1 &
+
     log "Restoring brightness"
     # TODO save and restore backlight settings
     echo 100 > /sys/class/leds/work/brightness