Miyoo Mini Plus: How to Run PICO-8 Games Natively (Step-by-Step Guide)

Running native PICO-8 on the Miyoo Mini Plus requires placing the official Raspberry Pi binary (pico8_dyn) into the OnionOS emulators directory. This replaces the default Fake-08 emulator core, restoring complete cart compatibility, working splore chiptune audio, and correct execution speeds for carts that use custom assembly routines or unofficial memory addresses.

Required Upstream Files

To execute official carts without syntax emulation errors, obtain the standalone Linux Raspberry Pi build from your Lexaloffle account:

• Archive name: pico-8_0.2.6b_raspi.zip (or newer)
• Target binary 1: pico8_dyn (Dynamically linked ARM binary)
• Target asset 2: pico8.dat (Contains core system fonts, Lua runtime, and audio tables)

Note: Do not use the static pico8 binary; the SigmaStar SSD202D processor in the Miyoo Mini Plus requires dynamic library linkage against OnionOS system libraries.

Step-by-Step Installation on OnionOS

1. Power off the Miyoo Mini Plus and insert the MicroSD card into your computer.
2. Open the file explorer and locate the /Emu/PICO/ directory on the root of your SD card.
3. If /Emu/PICO/bin/ does not exist, create the folder.
4. Copy pico8_dyn and pico8.dat directly into /Emu/PICO/bin/.
5. Open /Emu/PICO/launch.sh in a plain text editor (VS Code or Notepad++) and verify the launch execution wrapper:

#!/bin/sh
cd $(dirname "$0")

# Export library path for dynamic linker
export LD_LIBRARY_PATH=./lib:$LD_LIBRARY_PATH

# Set PICO-8 home directory to your SD card roms path
HOME=/mnt/SDCARD/Roms/PICO

if [ -f "./bin/pico8_dyn" ]; then
    ./bin/pico8_dyn -run "$1"
else
    # Fallback to Fake-08 if official binary is missing
    ./bin/fake08 "$1"
fi

6. Save the file with Unix (LF) line endings.

Enabling Splore Over Wi-Fi

The greatest benefit of running official PICO-8 silicon is Splore—the integrated cartridge browser that lets you browse, search, and bookmark community games directly over Wi-Fi without manually downloading .p8.png files to your computer:

1. Connect the Miyoo Mini Plus to your local 2.4GHz Wi-Fi network in Settings -> Wi-Fi.
2. From the OnionOS main menu, go to Games -> PICO-8.
3. Select “Explore New Cartridges (Splore)” or launch PICO-8 with no cart selected.
4. The official Lexaloffle BBS browser loads. Downloaded carts automatically save to /mnt/SDCARD/Roms/PICO/ and remain playable offline.

Performance Tuning: Fixing Audio Crackle and Screen Tearing

If audio crackling occurs during complex musical passes, edit the PICO-8 configuration file at /mnt/SDCARD/Roms/PICO/.lexaloffle/pico-8/config.txt:

window_fps 60
frameless 1
sound 1
sound_volume 256
audio_latency 64

Setting audio_latency 64 eliminates buffer under-runs on the 1.2GHz ARM Cortex-A7 core while keeping controller button latency under 1 frame.