Miyoo Flip: Up-to-date with main

.github/workflows/ci.yaml

@@ -21,7 +21,7 @@ jobs:
       release-name: ${{ steps.release-name.outputs.RELEASE_NAME }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v4.2.2
+        uses: actions/checkout@v7.0.0
         with:
           fetch-depth: 0
 
@@ -46,7 +46,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v4.2.2
+        uses: actions/checkout@v7.0.0
 
       - name: Generate cores matrix
         id: cores
@@ -69,7 +69,7 @@ jobs:
         core: ${{ fromJson(needs.core-matrix.outputs.cores) }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v4.2.2
+        uses: actions/checkout@v7.0.0
 
       - name: Setup
         run: make setup
@@ -78,7 +78,7 @@ jobs:
         run: make build-core CORE=${{ matrix.core }}
 
       - name: Upload core
-        uses: actions/upload-artifact@v4.6.2
+        uses: actions/upload-artifact@v7.0.1
         with:
           name: core-${{ matrix.toolchain }}-${{ matrix.core }}.zip
           path: workspace/${{ env.PLATFORM }}/cores/output/
@@ -92,7 +92,7 @@ jobs:
       RELEASE_NAME: ${{ needs.prepare.outputs.release-name }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v4.2.2
+        uses: actions/checkout@v7.0.0
 
       - name: Install dependencies
         run: |
@@ -103,7 +103,7 @@ jobs:
         run: make setup
 
       - name: Download Cores (tg5040)
-        uses: actions/download-artifact@v4.3.0
+        uses: actions/download-artifact@v8.0.1
         with:
           path: workspace/tg5040/cores/output/
           pattern: core-tg5040-*
@@ -115,7 +115,7 @@ jobs:
           PLATFORM: tg5040
 
       - name: Download Cores (tg5050)
-        uses: actions/download-artifact@v4.3.0
+        uses: actions/download-artifact@v8.0.1
         with:
           path: workspace/tg5050/cores/output/
           pattern: core-tg5050-*
@@ -145,19 +145,19 @@ jobs:
         run: make package
 
       - name: Upload All
-        uses: actions/upload-artifact@v4.6.2
+        uses: actions/upload-artifact@v7.0.1
         with:
           name: ${{ env.RELEASE_NAME }}-all.zip
           path: releases/${{ env.RELEASE_NAME }}-all.zip
 
       - name: Upload Base
-        uses: actions/upload-artifact@v4.6.2
+        uses: actions/upload-artifact@v7.0.1
         with:
           name: ${{ env.RELEASE_NAME }}-base.zip
           path: releases/${{ env.RELEASE_NAME }}-base.zip
 
       - name: Upload Extras
-        uses: actions/upload-artifact@v4.6.2
+        uses: actions/upload-artifact@v7.0.1
         with:
           name: ${{ env.RELEASE_NAME }}-extras.zip
           path: releases/${{ env.RELEASE_NAME }}-extras.zip
@@ -169,7 +169,7 @@ jobs:
           echo '::warning title=Attest skipped::Attest action requires permissions and is performed only for main branch.'
 
       - name: Attest Build Provenance
-        uses: actions/attest-build-provenance@v2.3.0
+        uses: actions/attest-build-provenance@v4.1.1
         if: github.ref == 'refs/heads/main'
         with:
           subject-path: |

.github/workflows/dev.yaml

@@ -21,7 +21,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v4.2.2
+        uses: actions/checkout@v7.0.0
 
       - name: Install dependencies
         run: |
@@ -41,7 +41,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v4.2.2
+        uses: actions/checkout@v7.0.0
 
       - name: Install dependencies
         run: |

.github/workflows/release.yaml

@@ -28,7 +28,7 @@ jobs:
       release-name: ${{ steps.release-name.outputs.RELEASE_NAME }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v4.2.2
+        uses: actions/checkout@v7.0.0
         with:
           fetch-depth: 0
 
@@ -65,7 +65,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v4.2.2
+        uses: actions/checkout@v7.0.0
 
       - name: Generate cores matrix
         id: cores
@@ -88,7 +88,7 @@ jobs:
         core: ${{ fromJson(needs.core-matrix.outputs.cores) }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v4.2.2
+        uses: actions/checkout@v7.0.0
 
       - name: Setup
         run: make setup
@@ -97,7 +97,7 @@ jobs:
         run: make build-core CORE=${{ matrix.core }}
 
       - name: Upload core
-        uses: actions/upload-artifact@v4.6.2
+        uses: actions/upload-artifact@v7.0.1
         with:
           name: core-${{ matrix.toolchain }}-${{ matrix.core }}.zip
           path: workspace/${{ env.PLATFORM }}/cores/output/
@@ -111,7 +111,7 @@ jobs:
       RELEASE_NAME: ${{ needs.prepare.outputs.release-name }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v4.2.2
+        uses: actions/checkout@v7.0.0
 
       - name: Install dependencies
         run: |
@@ -122,7 +122,7 @@ jobs:
         run: make setup
 
       - name: Download Cores (tg5040)
-        uses: actions/download-artifact@v4.3.0
+        uses: actions/download-artifact@v8.0.1
         with:
           path: workspace/tg5040/cores/output/
           pattern: core-tg5040-*
@@ -134,7 +134,7 @@ jobs:
           PLATFORM: tg5040
 
       - name: Download Cores (tg5050)
-        uses: actions/download-artifact@v4.3.0
+        uses: actions/download-artifact@v8.0.1
         with:
           path: workspace/tg5050/cores/output/
           pattern: core-tg5050-*
@@ -164,19 +164,19 @@ jobs:
         run: make package
 
       - name: Upload All
-        uses: actions/upload-artifact@v4.6.2
+        uses: actions/upload-artifact@v7.0.1
         with:
           name: ${{ env.RELEASE_NAME }}-all.zip
           path: releases/${{ env.RELEASE_NAME }}-all.zip
 
       - name: Upload Base
-        uses: actions/upload-artifact@v4.6.2
+        uses: actions/upload-artifact@v7.0.1
         with:
           name: ${{ env.RELEASE_NAME }}-base.zip
           path: releases/${{ env.RELEASE_NAME }}-base.zip
 
       - name: Upload Extras
-        uses: actions/upload-artifact@v4.6.2
+        uses: actions/upload-artifact@v7.0.1
         with:
           name: ${{ env.RELEASE_NAME }}-extras.zip
           path: releases/${{ env.RELEASE_NAME }}-extras.zip
@@ -188,7 +188,7 @@ jobs:
           echo '::warning title=Attest skipped::Attest action requires permissions and is performed only for main branch.'
 
       - name: Attest Build Provenance
-        uses: actions/attest-build-provenance@v2.3.0
+        uses: actions/attest-build-provenance@v4.1.1
         if: github.ref == 'refs/heads/main'
         with:
           subject-path: |
@@ -203,12 +203,12 @@ jobs:
     runs-on: ubuntu-24.04-arm
     steps:
       - name: Checkout
-        uses: actions/checkout@v4.2.2
+        uses: actions/checkout@v7.0.0
         with:
           fetch-depth: 0
 
       - name: Download Release Artifacts
-        uses: actions/download-artifact@v4.3.0
+        uses: actions/download-artifact@v8.0.1
         with:
           path: releases/
           pattern: NextUI-*
@@ -224,7 +224,7 @@ jobs:
           GIT_NEXT_TAG: ${{ needs.prepare.outputs.next-tag }}
 
       - name: Release
-        uses: softprops/action-gh-release@v2
+        uses: softprops/action-gh-release@v3
         with:
           files: releases/*
           generate_release_notes: true

.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
+```

README.md

@@ -1,3 +1,5 @@
+<h1>This project is currently undergoing a license transition. See [#765](https://github.com/LoveRetro/NextUI/issues/765) for details.</h1>
+
 <div align="center">
 
   <img width=128px src="github/logo_outline.png">
@@ -120,6 +122,7 @@ Our wiki has a [list of all available Paks](https://nextui.loveretro.games/pak-s
 
 - [josegonzalez](https://github.com/josegonzalez) for [minui-keyboard](https://github.com/josegonzalez/minui-keyboard)
 - [knulli-cfw](https://github.com/knulli-cfw)/[Mikhailzrick](https://github.com/Mikhailzrick) for [fan-control-daemon](https://github.com/knulli-cfw/knulli-linux/commit/5c1b4724330b59cbe8af79d0a7f1dac86f1c221a)
+- [Kenney](www.kenney.nl) for [Input Prompts](https://kenney.nl/assets/input-prompts)
 
 ---
 

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