spruceOS v4.5.6 Changelog
Join our Discord here!
Check out the wiki for info on ROM folders and apps Here
Changes since v4.5.4.
Message from SundownerSport
This has been another fun release cycle! We have a ton of new team members and contributors, new emulator cores and some really interesting developments.
I want to begin with a shout out to Seaside Studios for allowing us to bundle the DEMO of his new NES game Squatch Quest. The full game can be found here. I met him at the Portland Retro Game Expo this year and was super impressed with the game, his general vibe and honestly I just love all things SQUATCH!
We have a some new devices added and our little spruce forest continues to grow and mature. Please let us know if you find any bugs along the way we will try to get them handled ASAP. The devices that need a TF1 image can be a bit confusing but the spruce Installer app makes it really easy. Just select your device from the drop down menu in the TF1 tab and it will do everything else for you!
New Devices
- Powkiddy V10 (@Dmussi, @ryanmsartor)
- G350 (@CatalyticArkun @Sundownersport)
- MagicX XU Mini M (@CatalyticArkun)
- A10 Mini (@Sundownersport)
- Anbernic RG353M (in development, testers wanted!) (@ryanmsartor)
- MagicX XU20 V32 (@CatalyticArkun @ryanmsartor)
New Features
- PICO-8: native PICO-8 now has the spruce in-game menu, with save states! Save and load slots, resume where you left off, and saves follow your card between devices that run the same PICO-8 (the A30 and Miyoo Minis share theirs, and so do the 64-bit devices). Can be turned off in the Pico-8 system options (@Sundownersport, save states built on @josegonzalez's work)
- Casio Loopy, through the Gloopy core (@Sundownersport)
- armGBA core for GBA (@Jacob-Matthew-Cook @Sundownersport)
- Saturn: yabadabadoo core for the A30 and Miyoo Minis, also offered on 32-bit RetroArch for the Flip, Anbernic XX and dArkMoss devices (@ryanmsartor, @Sundownersport)
- Accent Color app: recolour themes that support it (@Dmussi)
- Firmware Update: Miyoo Mini Plus and Mini Flip OEM firmware, BaseOS updates on the Miyoo Flip, oakMOSS updates on MagicX, and update files you put on the card yourself (@Sundownersport, @CatalyticArkun)
- Miyoo Flip CAN now run on BaseOS (@CatalyticArkun)
- Cheevos updated to v0.3.0, and the game menu can open a game's achievement progress in Cheevos (@abalakh)
- Random theme on boot, under System Settings (@ryanmsartor)
- N64: new "Spruce (per device)" C-button mode, now the default; standalone GLideN64 runs on the PowerVR devices (@CatalyticArkun)
- Saturn standalone: in-game menu on the Anbernic XX, and the libretro core's button layout on every device (@CatalyticArkun)
- Flycast v2.7 standalone and libretro core built with GCC 10.3; the standalone and libretro core share one VMU set (@CatalyticArkun)
- GameTank: the gametank libretro core is now the default (@Sundownersport)
- Pixel Transparency shader by @SkyWalker541 (@ryanmsartor)
- Squatch Quest demo included for NES (@Sundownersport)
- ZRAM on the A30, and the ZRAM setting on MagicX devices (@WildEmu, @ryanmsartor)
- Anbernic XX clamshells wake when the lid opens (@abalakh)
- Smart Pro S: fan boost switch action (@mxmgorin)
- Bug reports: a GitHub issue form, and a QR code to it on the bug report screen (@Sundownersport, @Hairo)
Improvements
- PyUI is faster and smoother: steady 60 fps frame pacing, quicker menus and text, less redrawing while idle, faster startup (@chrisj951, @abalakh, @mxmgorin)
- Miyoo Mini reaches its menu about 4 seconds sooner (@abalakh)
- Smart Pro S boots faster (@mxmgorin)
- Recents now keeps up to 1000 games (@chrisj951)
- Themes are patched separately for each screen shape, and PyUI reloads only when the theme actually changes (@chrisj951)
- RetroArch configs refreshed for the Brick, Brick Pro, Smart Pro, Smart Pro S, Zero 28, Zero 40, XU20, A30 and V10: UI scaling, vibration on by default where there is a motor, hardcore achievements off by default (@ryanmsartor)
- PPSSPP configs refreshed for the Zero 28, Zero 40 and XU20, with X/O and Triangle/Square fixed on the Zero 40 and XU20 (@ryanmsartor)
- DSperate updated to v3.0.5 (@ryanmsartor)
- Flip and Miniloong: the GPU and memory clocks follow the CPU mode (@CatalyticArkun)
- TrimUI: newer system libraries for ports (@Sundownersport)
- Miyoo Mini: one set of per-model settings for every Mini, a low clock while the screensaver shows, and RetroArch keeps the chosen CPU mode after its menu (@CatalyticArkun)
- WiFi: faster boot when no saved network is in range, B leaves the WiFi wait at game launch, and TrimUI connects without stalling the radio (@Sundownersport, @abalakh, @duyquang6)
- Game switcher closes an emulator that won't quit by itself (@luigismith)
- Box art: interim image folders are cleaned up (@duyquang6, @Sundownersport)
- PyUI shows "Powering off..." when you power off from the menu, and themes can supply their own shutdown image (@abalakh)
- Brick Pro: the speaker amp follows the menu sound settings (@BackwardsCire)
- Bug reports hide more personal settings (@Sundownersport)
- Smaller download: duplicate and unused files removed, and shaders and DraStic assets are unpacked on the device (@ryanmsartor, @Sundownersport)
Bug Fixes
- RetroArch config no longer breaks when the RetroAchievements password contains & (@chrisj951)
- Cheevos App no longer crashes on the A30 (@Sundownersport)
- DraStic: save folders no longer nest inside each other (@luigismith)
- PrBoom and TyrQuake: quitting from the game's own menu returns to the game list (@luigismith)
- NAOMI and Atomiswave: arcade buttons 5 and 6 work again (@CatalyticArkun)
- Flip and Anbernic XX: WiFi no longer cuts Bluetooth on the shared chip (@Sundownersport)
- Flip: the charging indicator shows on USB power (@mxmgorin)
- Flip: card handling at boot and power-off is more reliable (@mxmgorin, @CatalyticArkun)
- Shutdown: the SD card is unmounted more reliably on every device (@CatalyticArkun)
- Miyoo Mini: the Menu key reaches RetroArch (@CatalyticArkun)
- dArkMoss: no forced low-battery shutdown while charging (@Sundownersport)
- G350 and XU Mini M: panel calibration settings the kernel rejects are hidden (@Sundownersport)
- Smart Pro S: the stock music server no longer starts (@mxmgorin)
- Another device's audio config no longer carries over when the card moves (@Sundownersport)
- LED settings only run on devices with RGB LEDs (@Hairo)
- Update check works when the clock is behind (@CatalyticArkun)
- OTA and update checks no longer report the device as offline on networks with broken IPv6 (@Sundownersport)
Installation
Installer App
Try the all-in-one installer app for a super easy installation! No need to download a release or format your card manually. Available for Windows, Mac and Linux! You can install spruceOS Stable, spruceOS Nightlies, any necessaryTF1 images, or twigUI (a spruce experience for GKD Pixel 2 only) in just one click!
The installer app can also be used to update an existing spruceOS installation to the latest version, or even scrape boxart for your library.
| Platform | Download |
|---|---|
| Windows (x64) | spruceos-installer-windows.exe |
| macOS (Apple Silicon + Intel) | SpruceOS-Installer-macOS-Universal.zip |
| Linux x64 | spruceos-installer-linux-x64.tar.gz |
| Linux ARM64 | spruceos-installer-linux-arm64.tar.gz |
| Linux ARMv7 | spruceos-installer-linux-armv7.tar.gz |
| Linux i686 (32-bit) | spruceos-installer-linux-i686.tar.gz |
These always grab the newest installer — see all installer releases here
Manual Installation
- Download spruceV4.5.6.7z
- Extract onto your PC using 7zip
- Copy the entire contents to a blank FAT32 formatted SD card.
- Seriously, use 7zip to extract onto your PC THEN copy the files. IDK why but Windows breaks stuff if you use its built in extraction tool.
- For 2-slot devices that require a TF1 image, download the appropriate TF1 image from the links below and flash it to a separate SD card. See the table below for which TF1 image is required for your device, if any.
OTA Update
spruceOTA-v4.5.4-to-v4.5.6.7zcontains only the files changed since the previous stable release.- It also contains a deletion manifest for files removed since the previous stable release.
- This package is intended for OTA updates from
v4.5.4tov4.5.6.
Supported Devices
| Device | Support Status | Separate TF1 Required? |
|---|---|---|
| Miyoo Flip | Supported | No |
| Miyoo A30 | Supported | No |
| Trimui Smart Pro | Supported | No |
| Trimui Brick | Supported | No |
| Trimui Smart Pro S | Supported | No |
| Trimui Brick Pro | Supported | No |
| Miyoo Mini Flip | Supported | No |
| Miyoo Mini Plus | Supported | No |
| Miyoo Mini v1-4 | Supported | No |
| Anbernic H700 devices | Supported | Yes, BaseOS |
| Powkiddy RGB30 | Supported | Yes, dArkMoss |
| Powkiddy RGB20SX | Supported | Yes, dArkMoss |
| Miniloong Pocket 1 | Supported | Yes, dArkMoss |
| Powkiddy V10 | Supported | Yes, dArkMoss |
| A10 Mini v1-4 | Supported | Yes, dArkMoss |
| G350 | Supported | Yes, dArkMoss |
| MagicX XU Mini M | Supported | Yes, dArkMoss |
| Anbernic RG353M | In development | Yes, dArkMoss |
| MagicX Zero 28 | Supported | Yes, oakMoss |
| MagicX Zero 40 | Supported | Yes, oakMoss |
| MagicX XU20 V32 | Supported | Yes, oakMoss |
Anbernic H700 series: These devices require a BaseOS TF1 image, which you can grab here. TF2 takes a standard spruceOS installation, so your spruceOS card stays freely swappable between supported devices.
Powkiddy RGB30, RGB20SX and V10, Miniloong Pocket 1, A10 Mini, G350, MagicX XU Mini M and Anbernic RG353M: these devices need dArkMoss on TF1, which you can grab here. TF2 takes a standard spruceOS installation, so your spruceOS card stays freely swappable between supported devices.
MagicX Zero 28, Zero 40 and XU20 V32: these devices need oakMoss on TF1, which you can grab here. TF2 takes a standard spruceOS installation, so your spruceOS card stays freely swappable between supported devices.
BaseOS, dArkMoss, and oakMoss images can be downloaded and installed automatically using the
TF1tab on the Spruce Installer application for Windows, Mac and Linux!