What's New

RetroArch has been updated on all devices to 1.22.2 with a new custom in-game-menu thanks to SundownerSport! This brings cheevos support to all devices.

ScummVM Standalone: This release gets rid of the RA cores completely, the standalone is better so we decided to just stick with it. ScummVM standalone has some compatibility issues with the various Miyoo Mini family of devices that we are working on and hope to resolve in the near future.

 - **Mini Plus (640x480):** **Works** controls, sound, rotation all good!                                                                                                            
 - **Mini V4 (752x560):** **Broken** Black screen with both stock and OnionOS SDL1.2, no sound. **Broken**.                                                                                                          
 - **Mini Flip (752x560):** **1/2 Broken** Video works with either SDL1.2. Audio only works with stock SDL, not Onion SDL. Controls messed up.                                                                         
 - **Mini V1/V2/V3 (640x480):** **Untested**

Special thanks to the Onion team! We used resources created by them for the 1.22.2 RetroArch and ScummVM builds included in this release.

Check out the wiki for info on ROM folders and apps Here

Join our Discord here!

Changelog

Improvements

• SundownerSport: Update all devices to RetroArch Version 1.22.2 with custom in game menu
• SundownerSport: Create new Tasks for clearing favorites and recents lists
• SundownerSport/wakeboxer: New ScummVM standalone support for all devices
• SundownerSport: ScummVM standalone auto save via Gameswitcher. Auto load at launch (only on supported engines)
• SundownerSport: Game search now includes MiyooGamesList XML names
• cobaltgit: Updated DOSBox Pure core
• Ry: Enabled M3U generator script from Amiga gameslist X button menu
• Ry: Cut shutdown time in-menu by 1.5 seconds
• Ry: Don't auto-enable hardcore cheevos on first login
• Ry: Ports control mode can now be configured per game
• Hairo: Added global screenshot shortcut (Y + L2 + R2)
• Hairo: Enable auto save/load in flycast default config
• Hairo: Vibrate when taking a screenshot
• Hairo: Update standalone emulator screenshots to be stored in SDCARD/Saves/screenshots
• Hairo: Update gallery app
• nco-design: Added PS1 boot logos and new bootlogos
• nco-design: New Theme "PS-modern" added to Theme Garden
• RDWilliamson: Add new Comic theme to Theme Garden
• amruthwo: Pixel Reader on A30!!!!
• chrisj951: Fix timezone not applying in RetroArch
• chrisj951: Allow adding/removing from recents
• chrisj951: Screenshot previews in RetroArch in game menu
• chrisj951: Improve WiFi selection screen to feel less laggy
• chrisj951/SundownerSport: Prevent OTA display from freezing
• chrisj951: Fix scenarios where various apps would freeze

Bug Fixes

• chrisj951: Fixed Sleep/Power button behavior across all devices
• chrisj951: Fixed audio issues on Miyoo Mini Flip
• SundownerSport: USB app exit bug fix
• cromerc: Fixed Syncthing configuration not loading
• Ry: PORTS control modes: check for per-game override, before checking system-wide setting
• chrisj951: Fix bug where adding a new wifi network deleted existing ones
• chrisj951: Fix inverted text of add/remove recents
• chrisj951: Fix buttons on wake of Miyoo Mini Plus
• chrisj951: Only modify audio on Miyoo Mini when DraStic is running
• chrisj951: Fix core fake-08 (Pico-8) core typo
• Hairo: Fix idle-timeout not longer applying after launching an app
• Hairo: Fix flip screenshots
• SundownerSport: Fix macOS junk file cleanup

Installation

New 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!
• Compatible versions for Windows, Mac and Linux!
• Find the Latest version for you PC here
• Lets you install Stable, Nightlies, Sprig (mini flip only) and Twig (GKD Pixel 2 only) all in one click!

Manual Installation

• Download spruceV4.1.1.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.

What's New

Check out the wiki for info on ROM folders and apps Here

Join our Discord here!

We are mostly focused right now on fixing bugs in the 4.0.0 release. We have unfortunately had a bit of backsliding on the Miyoo Mini series; sleep is basically broken and we are working on it but dont want to hold up this release for it when there are still other great CFW options for those devices. We recommend SprigUI for the Mini Flip if you want that "spruce" look and feel.

One of the bigger changes we made was to the shutdown sequence, there were a lot of reports of SD cards going "read only" and we believe our changes have addressed this.

Changelog

Bug Fixes

• Flip: explicitly stop network services when disabled in spruce settings (wakeboxer, Chris)
• TSPS: fix game switcher not adding games to list (Chris)
• Flush texture cache when low on memory to prevent PyUI crashes (wakeboxer, Chris)
• Fix transparency loss when optimizing boxart (wakeboxer)
• Allow backing out of collection creation without breaking functionality (Chris)
• Fix mis-reporting of new version available (Ry)
• Miyoo Mini Plus: fix screen misalignment (Chris)
• Miyoo Mini family: volume handling improvements for DraStic (Chris)
• A30: fix ScummVM core not launching (Sundowner Sport)
• Miyoo Mini family: preserve aspect ratio in RA games (Chris)
• Prevent unplayable ROMs from appearing in Recents (Chris)
• Fix sleep bug related to 0s shutdown timer (Chris)
• TSPS: use correct RA config when not using in-game menu (Ry)
• Fix Nintendo/Xbox control scheme swap for TrimUI devices; fix doubling of R3 and B buttons in Nintendo mode (g3nesis331, Ry)
• Brick: allow DraStic Steward to launch and display correctly (Chris, Ry)
• Flip: avoid accidentally entering smart CPU mode when unintended (ADTP)
• TrimUI: game switcher now captures PPSSPP screenshots (wakeboxer)
• Miyoo Mini family: fix game switcher JSON not updating (Chris)
• TrimUI: menu button now opens RA menu or GS when in-game menu set to false (Ry)
• SmartProS: fix Saturn (Chris)
• Universal brightness hotkeys fixed on TSPS (Ry)
• Kill idlemon when launching apps (Sundowner Sport)

Improvements

• Improve WiFi quality reporting in PyUI (wakeboxer, Chris)
• Add Catalan language file (GuillemRoca)
• Allow .dat files to show in NAOMI and DC systems (ar_, Ry)
• Allow alternate ROM folder naming schemes to show in PyUI with correct emulators (Chris, Ry)
• Speed up ROM folder checking (Chris)
• Allow ignore list in emu config.json to hide BIOS files from UI (Chris)
• Swap Fishooter free game for Cubicle Knight (Sundowner Sport)
• Added additional systems to scraper (Sundowner Sport)
• Further scraper optimization and speedup (Sundowner Sport)
• Initial implementation of Activity Tracker (Chris)
• Rename Miyoo Gamelist app to "Gamelist.xml" to reduce confusion (Sundowner Sport)
• Miyoo Mini family: set max CPU clock differently for smart/performance modes (Chris)
• Add longer shutdown-from-sleep options (Ry)
• Update Syncthing to 2.0.13 with additional improvements (Chris Cromer)
• Better alignment of battery percentage and displayed icon in PyUI (Ry)
• Absolutely tons of stuff for Pixel2 (Hario)
• Flip: add setting to disable lid sensor globally or while plugged in (Ry)
• Brick, TSP: add Advanced DraStic as option for NDS emulation (trngaje, Ry)
• Flip: update version for DraStic Steward (Ry)
• Added LittleBigMiyoo bootlogo to bootlogo app (AlpineShowTime)
• TSPS: updated ra64.trimui to RetroArch 1.22.2 (TrimUI)
• SD card auto repair trigger is now more sensitive (Ry, Chris)
• Explicitly unmount bind mounts prior to shutdown to reduce improper SD card unmount (Ry)
• Add timeout and send SIGKILL if emu SIGTERM fails on poweroff to prevent hard shutdowns (Ry)
• A30: add adjustable frequency for Overclock mode in System Settings (Ry)
• A30: update LudicrousN64 core, enabling more core options (KMFDManic)
• Updated list of pack-in themes, including new GREEN theme (rdwilliamson, Ry)
• Fleshed out standard gamelist.xml files for arcade systems (Sundowner Sport)
• New "bug report" task for easier log/config submission to devs (Hario)
• Descriptive list view enhancements; box art can now appear in icon slot in game lists (Chris)
• Scraper now cross-references databases for related systems (e.g. GB with GBC) (Sundowner Sport)
• Gamelist.xml app shifted to Python and fixed up generally (Sundowner Sport)
• TSPS added to USB mode app (KARPezz)
• 64-bit devices: add Gallery App screenshot viewer (Hario)
• Shutoff unmount fix (Ry)
• Allow .pbp files and homebrew to show in PSP game list (Ry)
• Add PPSSPP standalone app (Ry)
• Add ScummVM standalone initial implementation (wakeboxer)
• Added GME core and associated file extensions to MEDIA system (Sundowner Sport, Hario)
• Updated handling of gamelist.xml for FBNeo (Hario)

Installation

New 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!
• Compatible versions for Windows, Mac and Linux!
• Find the Latest version for you PC here
• Lets you install Stable, Nightlies, Sprig (mini flip only) and Twig (GKD Pixel 2 only) all in one click!

Manual Installation

• Download spruceV4.1.0.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.

Spruce 4.0 Stable is here!

Updating via OTA from 3.3.2 is not recommended due to that large number of changes

We HIGHLY recommend a fresh install of 4.0.0

The all in one Installer app has an update feature that should work as well but is not extensively tested

We have been cooking on this for a really long time, and we think it is finally at a point where we are comfortable calling it a stable release! So far this release will work on a BUNCH of devices, we have been focusing mainly on making sure the A30 and Flip are the most stable but other devices are honestly pretty dang close as well.

Releasing this stable 4.0 has a few goals for our development; we hope to clear the decks a bit and be less careful of breaking a nightly release and a solid base for bug reports to come in through where we dont have to guess which nightly version people were on. We have been really happy with all the community support, bug reporting, help and just general vibes we have gotten from the community in the past year.

We have opened up our once private development Discord server to the public and its been really great! Please come on by if you feel like hanging out and chatting with the team, asking questions or reporting issues.

I want to give a special thank you to all of the contributors we have had throughout the life of this project. We are an all volunteer team who do this for fun with any spare time we have in our lives. Thank you guys! You are truly the best, I am lucky to have you as my friends, and working with you on spruce is super rewarding.

This release would never have been possible without all of our contributors but especially Chris and Ry. They have become the solid core of the development of spruce. If you see them around on Reddit or Discord, give them the praise they deserve!

OK!

Now for the details!

What's New

• New Python based front end UI (PyUI)
• 3000+ new commits since 3.3.2
• New Themes! (special thanks to RDWilliamson)
• Stuff!
• Things!
• New Devices!
• WOW!
• Seriously ya'll there is SO freaking much new its INSANE

Updating

• Due to the huge variety of Nightly versions people might have and the extremely large number of changes from 3.3.2 we generally recommend a fresh install of 4.0.0 stable.
• At the VERY LEAST due a "manual update".

1. Delete everything EXCEPT the Roms BIOS Saves Collections and Persistent folders from your SD card.
2. Download the .7z release.
3. Extract onto your PC using 7zip
4. Copy and paste ALL files from this folder directly to the root of your fresh SD card. Make sure to get the hidden .tmp_update folder!
5. Boot your device with this SD card inserted into the righthand slot if your using a Flip.
6. Give it a few minutes and let it do its thing! When the installation is complete, you will land in spruceUI.

New 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!
• Compatible versions for Windows, Mac and Linux!
• Find the Latest version for you PC here
• Lets you install Stable, Nightlies, Sprig (mini flip only) and Twig (GKD Pixel 2 only) all in one click!

Manual Installation

• Download spruceV4.0.0.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.

ARE YOU LOOKING FOR SPRUCE ON THE FLIP, BRICK OR TSP?? YOU NEED A RELEASE FROM OUR NIGHTLY REPO INSTEAD!
https://github.com/spruceUI/spruceOSNightlies

Spruce v3.3.2
Small update, work continues on our multi-platform release, we've said it in a few places but we are working on supporting the Miyoo Flip, TrimUI Brick and TrimUI Smart Pro at the same time with this next release (v4.0.0). (Hopefully that plan doesn't change) This will be our first foray off the A30. Obviously those devices won't have 100% feature and app parity but we are hopeful to offer a decent experience and then build upon it. OTA's are already working for example, so when we release it updating should be a breeze from day 1. No real ETA yet though.

Check out our repo of various free games and ports!

Changes/Additions:

• Theme Garden: This is a new app to preview and download themes directly from our themes repo. After your first run if any new theme was added from the last time you opened it that will show up first with a 'new' tag. (This also has a secret feature to re-install/update all of your installed themes (Press start). Sometimes themes get updated so this can occasionally be useful, but until we work out theme versioning this is just a catch all bonus) (Xan)
• Added a global time out to Syncthing Checker (Stefan)
• Added a stall checker time out to Syncthing Checker (Xan)
• Added a task to Adv Settings to sort themes, this will also be ran automatically after using the Theme Garden (Xan)
• Exposed TGBDual core for GB/GBC for users to switch to in MainUI (has best compatibility for certain troublesome titles like Spidersoft's pinball games - thanks Doug!) (Ry)
• General improvements to unpacker process, should lead to better communication as to what's happening and gives us greater flexibility (Xan)
• Added new black and white hotkey reference image to boot logos (djaysan)
• Added "Beta" release support to OTA & Updater: As of right now I'm not sure how often we'll use this but the need was there with this branch so now we support Beta releases. For now this will be just something that's built in going forward, if we release a beta we want people to try we'll certainly communicate that and how to switch to it on Reddit or Discord. For now it'll just be a secret toggle. If we use them often enough it might become a setting. (Xan)

Bug Fixes/Removals:

• Fixed Boxart Scraper show blank or broken displays that occurred with certain themes, and added brief pause to display for each system to reduce flashing (Ry)
• Fixed "start to cancel" not cancelling in all scenarios for Syncthing checker (Stefan)
• Fixed 1% or less not communicating properly what was happening when first turning on with low battery (Xan)

Downloads:

Fresh Install click here

Wiki instructions

Update from 3.0.0 or newer click here

Wiki instructions

Update from pre-3.0.0 click here

Wiki instructions

spruce v3.3.1 - Bug squashing
This is just a minor update to get some bug fixes and bad interactions resolved.

Check out our repo of various free games and ports!

Downloads:

Fresh Install click here

Wiki instructions

Update from 3.0.0 or newer click here

Wiki instructions

Update from pre-3.0.0 click here

Wiki instructions

Themes:

Checkout our newly revamped Themes repo
https://github.com/spruceUI/Themes
We have new themes and are getting more!

Changes/Additions:

• Added boot to random game option in Adv Settings (Cobalt)
• Changed "Add to favorites" to 'Add/Remove Favorite' in the X menu. This option will now toggle favorites on a game. (Xan)

Bug Fixes/Removals:

• Fixed bad migration for users using changed setting "Boot to GS". This was resolved a bit after 3.0.0 was live so early downloads were affected but not any more. (Ry)
• Fix for still existing bad migrations that early users may still have (Xan)
• Fixed "Add to favorites" in x menu not using 'pretty' name from Miyoogamelist (Xan)
• Fixed "Add to favorites" in x menu not using sub folders (Xan)
• Fixed favorites, recents, and game switcher games from 3.2.0 or below no longer working with new launch scripts. (Xan, Ry)
• Fixed "Start to skip" not working reliably with Syncthing Checker (Xan)
• Fixed Syncthing checker not skipping when no devices are configured (Xan)
• Fixed RA pause getting out of sync when home is used as the hotkey enable (Xan)
• Fixed possible false fire of hold action when using home as a hotkey and pressing multiple hotkey combos within a specific window (Xan)
• Fixed broken QR code in Sapling Guide (Xan)
• Removed Mac index files from Pico-8 theme (Xan)
• Cleaned up unnecessary files from all themes (Xan)

Updating

Fresh Install instructions

Update from 3.0.0 or newer instructions

Update from pre-3.0.0 instructions

Credits/Thanks

Spruce v3.3.0

PLEASE USE THE OTA UPDATER APP! MAKE IS VISIBLE IN ADVANCED SETTINGS APP AND RUN IT!

YOU WILL GET UPDATED WITHOUT ANY FUSS!

Check out our repo of various free games and ports!

Downloads:

Fresh Install click here

Wiki instructions

Update from 3.0.0 or newer click here

Wiki instructions

Update from pre-3.0.0 click here

Wiki instructions

Themes:

Checkout our newly revamped Themes repo
https://github.com/spruceUI/Themes
We have 7 new themes and are getting more! (Thanks HeyDW, antonlabz, and Metallic77)

Breaking Changes:

• As of this update all network services now use the log in info of username: spruce and password: happygaming for most the old login should also work except Samaba, so if you have logins saved on various tools for the old Samba logins they will need updated.

Changes/Additions:

• Perfect Overlays: A new setting was added in Advanced Settings to toggle Perfect Overlays for the GB, GBC, and GBA consoles. This was done with input and direct collaboration with MugWomp93 and advice from 1PlayerInsertCoin to make sure they are what they should be. These will apply all the standard settings within RA for you. Even if you wish to use your own overlays I'd recommend turning on the setting then adjusting your RetroArch overlays afterwards. These attempt to recreate the screen and color experience of those handhelds on the A30. (XanXic, MugWomp93, 1PlayerInsertCoin)
• Services Landing Page: This is a bit of an experiment to help out with the various network services. There is now a landing page if you navigate to the root of your A30's IP address when on the same wifi network. This will show links and login info for the network services you have on in Advanced Settings. (So if your A30's ip address in Settings>Wifi is 10.0.0.120, opening this in a browser will take you to the landing page). Hopefully this can help for when you forget the various ports or logins. (My hope is other UI/FW's steal this idea as well, MuOS please :D -Xan) (Dandon, Xan)
• Added 'boot into splore' option to Adv Settings. (Cobalt)
• Added a corrupted SD Card detection and repair utility. (FragBait)
• Added fast forward while R2 is held when playing GB, GBC, and GBA games. (Xan)
• Added "Add to Favorites" to the X menu in normal and simple mode. (Kickbutt101)
• Added caching system to Game Nursery, currently set to 20 minutes so if you close and re-open the Nursery it doesn't need to fully download and setup again. (Xan)
• Added Overlays by Sky_Walker and SamuraiCowboy. (SundownerSport)
• Added Sharp-Shimerless shader to RetroArch. (Xan)
• Added a restart hotkey for the main menu in designer mode. (Home+L2) This can be useful when adjusting icons while the system is on and you want to re-render elements. (Xan)
• Added an option to reset PPSSPP configuration to Adv. Settings. (Dandon)
• Updated Cap32 core to the lastest, enables "crop borders" core options. (Metallic77)
• Adjusted PPSSPP hotkey's to match our standard hotkeys in RetroArch (Dandon)
• Adjusted "Rewind in RetroArch" setting to exclude PSX since it caused performance issues and wasn't very usable. (Dandon)
• Adjusted Samba and SSH to use the same 'spruce/happygaming' user and pass our other network services use so they are all now the same login. (Dandon)
• Adjusting emulaunch to dynamically and directly call standard_launch reducing extra files. (Cobalt)
• Rewrote Core switching and Cpu speed scripts to be more robust and responsive. (Ry)
• Rewrote our ThemeUnpacker utility to be more generic and more defined by when unpacking is relevant. Allowing some utilization by other things or people. This could be used to release a custom patch to Spruce that will install automatically for example (Xan, Ry)
• Made OTA (Spruce Updater) app shown by default to help discoverability, this can still be hidden in Advanced Settings. (Xan)

Easy Custom Systems (Ry):

• Added a "custom system" Emu folder that advanced users can modify or use as a template for adding additional RA-based systems to the games menu. (One use case might be splitting out Daphne games from Dreamcast, or MSX2 games from MSX.)
• Modifying the config.json and config.json.simple will allow them to set things like the display name, the icons being used for the new system, and allowed file extensions to show up in the games list.
• Modifying default.opt will allow them to set which RA core they wish to use and the minimum CPU speed while in Smart CPU mode.
• If spruce does not ship with the desired RA core, or you wish to use a different version of a spruce-included core, you may optionally add a compatible version of that core with a name matching what you have set in default.opt to the custom system's Emu folder, and it will use that instead of whatever is in spruce's RetroArch cores folder.
• Because the names people give to these systems may vary widely, spruce cannot and will not back these emulator configs up. Please keep your own backups for reinstallation after system upgrades.
• Add HeyDW's Blue theme.
• Added PICO-8 theme (369px)
• Add Hotkey image by XanXic to bootlogo.bmp collection (djaysan)
• Replaced Flycast April-2022 lr-flycast with lr-flycast of March-2021 (faster on my tests)
  It's a faster-tweaked version with (Metallic77)

-Postprocessing disabled
-SH4 downclocked to 160mhz
-Upscaling textures disabled
-Dynarec optimized for low-end

Bugfixes/Removals:

• Fixed Splore not checking for/initiating wifi before starting. (Cobalt)
• Fixed Random game app/script hanging and not working (Dandon)
• Fixed home not properly preventing extra inputs. (Xan)
• Fixed duplicated virtual keyboard inputs in Fuse core. (Metallic77)
• Fixed default icon paths for apps so they don't require an initial iconfresh to show. (Ry)
• Removed Planet Merge to help reduce install. It's still available in the Game Nursery! (SundownerSport)
• (369px) After updating, custom themes won’t get replaced anymore. (369px)

Updating

Fresh Install instructions

Update from 3.0.0 or newer instructions

Update from pre-3.0.0 instructions

Credits/Thanks

OTA Update oh my!

You can update to this Release via WiFi! Simply click on the Check For Updates App (make sure you have a good wifi connection first please!) and you should be off to the races! As always, the Wiki pages will be updated over the coming days to include the new features. Please let us know if there are any random bugs. Dm's, GitHub issues or just spamming Reddit and Discord will all work. Huge thanks to the team, this was a big update with some really fun new features.

In other news, we are starting work on porting spruceOS to the Miyoo Flip and will be releasing a Beta version ASAP. We are still waiting for all the team members to receive their dev units but work will start full tilt very soon!

Happy gaming..........

-SundownerSport

Downloads:

Fresh Install click here

Wiki instructions

Update from 3.0.0 or newer click here

Wiki instructions

Update from pre-3.0.0 click here

Wiki instructions

Changes/Additions:

General:

• Game Nursery: (Aka our simpler version of PortMaster) This is our new app to download games directly from our Ports repo on device. For now it just shows the "ready to play" ports and free homebrew we have, but we'll expand its functionality and offerings as we go. The A30 is not compatible with PortMaster, so this is our attempt to fill that void. (Ry)
• Simple Mode: (a.k.a. Kiosk mode/Kid mode) This is our first pass at a more locked down version of spruce that should be fit for a kid to keep them on rails a bit more. In this mode, the settings tile is hidden, our Advanced Settings app has a much more parsed down set of harmless options, things like x menu and more complicated features are disabled. The spruce default tap (menu)/ hold (gs) setup is used for home key. With this you can pre-configure the device how you think best prior to turning it on, and once ready turn on simple mode. (Located in the 1st tab at the end of Advanced Settings). A wiki page with more details is coming. To exit "Simple mode" perform the Konami code on the main menu. (No extra lives given) (Ry, XanXic)
• "Sapling Guide" App: this is a quick app to show the RA hotkeys, and a few simple features of Spruce. This can be hidden in adv settings. Hopefully this will help out with all those A30's destined to be stocking stuffers this holiday season! We plan to make a more robust separate guide/wiki app in the future. But we wanted to get a quick easy way to see basic info for people ASAP. (XanXic)
• M3U Generator added to the X button menu for disc-based systems. This will allow you to run an automated script to create an M3U playlist for multidisc games and have them present as a single game within spruce. (Cobalt)
• Boot Logo app rework, greatly reduce (if not outright prevent) possibility of bricking, added support for .png files. Automatically rotates, resizes and compresses the logo. (369px)
• Exposed fmsx core for MSX system. (Cobalt)
• Exposed bluemsx and gearsystem cores for SG-1000. (Cobalt)
• Pico8 dat/dyn files can now be dropped on the root of your SD card and will automatically move to the proper location. (Ry)
• Added /BIOS folder as an alternative location to stow your Pico8 dat/dyn files. (Ry)
• Made it so tap/hold actions are cancelled when other buttons are pressed when using home key. This allows the home key to be used as the hotkey enabler in RetroArch and reduces unintended behaviors in DraStic. (XanXic)
• Added universal exit hotkey combo: press home key + start (in that order). This was a bit of a late addition, so there may be odd edge cases; if so, let us know. (XanXic)
• Added joystick controls to File Management, Dino Jump, and Planet Merge. (Ry)
• Added support for hidden networks to multipass.cfg. (Gerard Szulc)
• Added DraStic config and settings to backup/restore. (thanks cvlnomen for mentioning it) (XanXic)
• Added a pause to emulation while home key is held, so the game doesn't continue while launching a hold action (OscarAu)

Advanced Settings Changes:

• "Expert" settings toggle added. In an attempt to help simplify the menu for those possibly intimidated by the many options. This will hide/show some of the more technical settings and tasks. When turning it on/off it'll apply after you save and then open it again. For existing spruce users updating to 3.2.0, this will be on by default to match your current experience; for new users, this will be off out of the box. But no settings have actually been removed. (XanXic)
• N64 controller profiles added.
  • Classic: This is the legacy default configuration. To use the C buttons, you must hold R2 and press one of the face buttons corresponding to the cardinal direction.
  • Action: This maps each of the C buttons to a single button on your A30. This is good for games like Zelda where the C buttons function as action buttons and you don't want to have to use button combos.
  • Custom: This setting is pre-configured like the Classic setting, but will respect any changes that the user makes. This remap file is backed up whenever the user exits an N64 game while using the Custom profile, and changes to it will persist even if they switch to the other profiles (which are always respected if set) before coming back to Custom. It is also backed up by spruceBackup and so should persist across upgrades.
• Added "home" as an option for the RetroArch hotkey enable key setting. With the above change to home key behavior, now home key can be set and used as such without being interfered with by the tap/hold actions. (XanXic)
• Added 3 additional Pico8 controller profiles that swap X/O. (Thanks Thaddeus Gray for suggestion) (Ry)
• Advanced settings app now allows looping across tabs and vertically across options. (OscarAu)
• Added Prev/Next labels at the top to help communicate there's other tabs! (OscarAu)
• Added a 'use Rewind' toggle for RA replacing the slowdown toggle with rewind and turning on the rewind service. Just an FYI this can cause some performance loss, it's why we don't have it on by default but now you can easily turn it on for yourself. (XanXic)
• Added a few more tasks to help restore errors or bad RA configs. (XanXic)
• Added a task to cleanup leftover Mac files like DS_Store that will show if they are detected on the SD card. (Cobalt)

Boxart Scraper:

• Added a fallback location for the libretro boxart thumbnails we scrape from, in case the main website stops working again. (We are working on more alternatives for future updates) (Cobalt)
• Made images dynamically generated, giving improved UI experience, and removing around 150+ prebaked images from Spruce. (Cobalt)
• Fixed BoxArt Scraper not communicating the errors it was experiencing clearly, now has more error detection and specific messages. (XanXic)

Bugfixes/Removals:

• Fixed powerdown in sleep not powering down while in game switcher. (Fragbait)
• Fixed a bug where "max number of games" setting in game switcher wasn't being respected. (OscarAu)
• Fixed Pico8 carts not reliably importing from the Pico8 import script (Located in the X menu). (Ry) (thanks Thaddeus Gray for the bug report)
• Fixed updater not restoring what apps were shown/hidden prior to updating. (XanXic)
• Fixed ZX Spectrum control issues by setting input devices 2-5 to "0" none on fuse core remap file. (Thanks u/Sppire for the tip!) (Ry)
• Initialized game switcher list file to prevent freezes on first boot if no game has been added yet (Sundowner Sport)

Known Bugs:

• Previously thought fixed, we have identified background music is not being allowed to play. We've figured out the culprit and have reproduction steps, just didn't have time to fix it in this release. No known workaround at this time.
• Introduced in this release, using home as a hotkey enable in RetroArch still has some odd interactions at times. Tap/Hold actions will not fire but RetroArch isn't being properly unpaused. It tested fine but some last minute bug fixes caused an awkward interaction. We don't recommend using it just yet despite the option being available. This will be fixed in the next update.
• If using home as a hotkey and using other combos, following up with start can still fire the universal exit combo. (ie Home+R1 to save, then pressing start immediately after will exit.)

STOCK CARD CONTENTS MINUS ROMS AND BIOS.
And
Miyoo Firmware update to add Bluetooth. This is the firmware update file directly from Miyoo

This is an unsupported release. This is NOT "SPRUCE".
This is an unsupported release. This is NOT "SPRUCE".
This is an unsupported release. This is NOT "SPRUCE".

I deleted a ton of stuff, Ports, games, bios (even some sneaky random ones in odd places).

PLUS!

I have added:

Pico8 and Dingux Commander from Ninoh Fox!

https://github.com/Ninoh-FOX/Pico8-Splore-Miyoo-Flip
https://github.com/Ninoh-FOX/Commander-miyoo-flip

This is an unsupported release. This is NOT "SPRUCE".
This is an unsupported release. This is NOT "SPRUCE".
This is an unsupported release. This is NOT "SPRUCE".

Spruce v3.1.0

The OTA update!
Future Releases will be available via OTA.

We have added a License! Spruce is free to use, download, share and edit, but using it for commercial purposes without written permission is prohibited.

Want free games without worrying about piracy?
Check out our free games and ports!

Known Bugs v3.1.0

• There was a script to update people from 3.0.0/3.0.1 using the tap to use GS, to have the same experience on the tap/hold system but it's doing the opposite of our intention. If you didn't have this option on you will have GS on tap and menu on hold after updating unfortunately. Go to Advanced Settings, use the R1 key to navigate to the emulators tab and set the tap and hold of home key how you would like to fix it. This will be fixed for people updating in the next update.

Changes/Additions:

• OTA Updater: (Aka Over the air updates, or Spruce Updater) Added our own updater, this will download and install the latest release from our GitHub releases page. Starting from 3.1.0 on you no longer need to manually update. It will be in your apps under "Check for Updates" or if an update is available.. "Update available". After a fresh install this app will be hidden, you can show it if you like in the Advanced Settings visibility toggles. Combined with the auto-update checker, detailed below, you could go without seeing it until an update is available. But this can be ran at anytime to manually check for new updates. The app will download the newest release and will run the EZUpdater app to install it. You can also choose to download and install later through EZ Updater if you wish. This leverages our previous work so your configs and settings are kept. (XanXic)
• Auto update checker: A new advanced setting, if you have this, on by default, and wifi on, after a new startup Spruce will check if an update is available occasionally. If so it'll add the updater app to your apps and give you notice next time you reboot. (XanXic)
• Home key controls: Added new settings to define what tap and hold of the home/menu key does. Now you can make your own setup for what it does. (Oscar)
• Added new quick exit action to the tap/hold home key options (Oscar)
• Reduced 'hold' time for the home key to 1.6 seconds from 2, added vibration when hold 'fires' (XanXic)
• Sleep then shutdown: Added automatic shutdown after x minutes in sleep feature (FragBait)
• Added new vibration strength/off setting in advanced settings (Ry, XanXic)
• Fake08: Added enable .png support setting (Ry)
• Pico 8: Added new controller layouts setting so you can decide how the buttons work, also added a 'full screen' setting for Pico8 (Ry)

Racing - this is the current default since spruce 3.0.0:
A-(o) B-(x) L1-(o) R1-(x)
Double - this is Ry's personal preference:
A-(o) B-(x) Y-(o) X-(x)
One-handed - Allows most games to be played with only the left hand:
A-(o) B-(x) L1-(o) L2-(x)
Steward - Legacy mode from pre-3.0.0; only one set of O and X, but also enables a unique mouse mode and access to the ESC key, which the SDL2 version that enables gamepad mapping does not have access to.
A-(o) B-(x) X-(esc) SELECT-(mouse)

• Added on board QR generator, expect errors to give QR codes directly to wiki topics in the future. For now this is how OTA Updates will link you to the changelogs (FragBait)
• Added SFTP, over SSH (FragBait)
• Bluelight Filter: Added in advanced setting, this is our initial attempt, we will dial this in and add sceduling in a future update. It’s manual for now. (FragBait)
• Changed default Lynx core to Handy (Cobalt)
• Syncthing: Greatly improved Syncthing Sync Checker times across the board for all scenarios with the total sync process taking anywhere from nearly instant to 5 seconds now, down from 13 seconds. (BaseInfinity)
• Added QuickNes emulator for NES systems (Cobalt)
• Added gearcoleco RA core for Colecovision emulation (Thanks jonnyandroid for the suggestion) (Ry)
• Added an automatic cleanup script to remove apostrophe's (') from sub folder names in roms. These are incompatible with MainUI (Ry)
• Added automatic save and shutdown when battery hits less than 1%. Both to save your game and prevent an issue with soft bricked battery (Ry)
• Stick delete: Added an option to disable joystick in settings for stick delete modders (Oscar)
• Added “designer mode” to show all consoles and give access to our Theme Packer app so theme creators can have an easier time. Check the information for creating themes on our wiki (XanXic)
• Themed SFTPGo/Wifi file transfer with spruce elements and A30's (Veckia9x)
• Added and cleaned up icons for new and existing apps (SundownerSport)
• Some advanced settings options shifted around. We are still feeling this app out as we expand on it, so please bear with us release to release as we find the best setup (Team Effort)

Bugfixes/Removals:

• Fix uae4arm audio sync issues (Metallic77)
• Fixed being locked out of games in Fake08 by adding a core override disabling auto save/load states (Ry)
• Fixed PPSSPP now emulates inserted Memory Stick (Cobalt)
• Fixed spruce restore not restoring "Recents" in main menu for those users (XanXic)
• Fixed a network/wifi broken state issue when disabling WiFi and Network Service in game (BaseInfinity)
• Fixed background music not playing (We aren't sure who fixed this, just noticed it was fixed)
• Using select+L1/R1 will no longer control volume. This was interfering with hotkeys for something hardly used. Start+L1/R1 will still control brightness (Oscar)

Downloads

Fresh Install click here

Wiki instructions

Update from 3.0.0 or newer click here

Wiki instructions

Update from pre-3.0.0 click here

Wiki instructions

Additions:

• Advanced Setting task added: Reset Retroarch config, use this to reset your RetroArch's main config to the spruce defined defaults. (XanXic)
• Advanced Setting task added: Reset Emufresh, use this if you're having problems with consoles, and/or roms not showing in your game lists. (XanXic)
• Enabled CHD detection for PPSSPP, CHD roms should now be seen by spruce and usable in PPSSPP (Ry)
• Auto/EZ Updater: Error messages made more explicit, swapped to "A to continue" prompts, and updater given some rough SD Card corruption detection, this will be beefed up in the next release. (XanXic)

Bugs Fixed:

• Fixed joystick not being recognized in Drastic/NDS (Oscarcau)
• Fixed Pico8 games added to Roms folder not detected and automatically updated in the gameslist. (Oscarcau)
• Fixed Syncthing checker causing some freezing when zero folders are setup (Baseinfinity)
• Fixed Syncthing checker being superceded by "Disable network apps in game" should now play nice with each other (Baseinfinity)
• Fixed Syncthing not being able to be ran by first time users (Baseinfinity)
• Fixed internal wifi detection to detect it can reach other network addresses (Baseinfinity)
• Removed unusable Genesis+GX Core (Cobalt)

Note:

You might need to reinstall Ports as some of them may have required parts deleted during the update process.

DOWNLOADS:

FRESH INSTALL ----- See wiki for detailed instructions

UPDATE FROM 3.0.0 ----- See Wiki for detailed instructions

UPDATE FROM PRE-3.0.0 ----- See wiki for detailed instructions.

There is also a Patch available for users already successfully on v3.0.0, simply extract the contents of this zip file onto the root of your SD card and let the files overwrite (Windows) or merge (Mac). Somewhat experimental. If you don't trust yourself stick with Auto/EZ Updater.