spruceUI/spruceOS

• SpruceOS is a community software package intended to help you get the most out of your Miyoo, TrimUI and Anbernic RG XX devices.

• Our mission is to provide a balanced user experience for both brand new and well-seasoned emulation enthusiasts alike: sane and well-optimized defaults for those who don't want to tweak settings, but immensely deep customization options for those that do.

• Spruce is intended to be sleek, intuitive, efficient, and user friendly. We hope that you enjoy it.

  We are not responsible for damage to your device. You must use spruce and its features at your own risk.

  

• Snappy and incredibly themeable custom Python-based UI.
• Game Switcher: seamlessly switch between save states during gameplay.
• Autosave on shutdown/autoresume on boot: automatic save state when powering off in-game; powering on will resume play from where you left off.
• Network services: Retroachievments, RTC sync via WiFi, SSH/SFTP, Syncthing, Samba and HTTP file transfer.
• CPU performance profiles pre-configured for optimized battery life and performance.
• Native Pico-8 support with Splore.
• Built-in boxart scraper app using libretro API.
• OTA updates over Wi-Fi on device.
• Game Nursery for downloading free ports, demakes, and homebrew for a variety of systems, directly to your device.
• Theme Garden for browsing and downloading an ever-growing (currently over 80!) selection of community-made themes

• CLICK HERE FOR THE LATEST RELEASE

• CLICK HERE TO SEE THE WIKI

• The short version is: format your SD card to FAT32 and extract the 7z (using the 7zip app) file to your PC, then copy the files onto your SD card.
• For more information, see the new Wiki installation page
• Place your BIOS files in the BIOS folder on the root of SD card.

• Download The spruceOS Installer program
• Simply insert your SD card into your computer and run the program, be sure to select the correct drive!
• It formats your card, downloads the latest official spruce release, and installs it in one click!
• Now V1.1 has a boxart scraper!

To update:

See our updating spruce Wiki page for more info

• Quicksave + Shutdown: Hold POWER for 3 seconds*
• Game Switcher: Hold MENU for 3 seconds
• Brightness down: START + L1 or MENU + VOLDOWN
• Brightness up: START + R1 or MENU + VOLUP

*Holding POWER after the vibration occurs will cause your device to force shutdown (in case of freezes etc.)

• MOD: SELECT or MENU, depending on the device (can be changed either in RA or in spruce settings)
• Screenshot: MOD + A
• Exit to spruceUI: MOD + B
• Open menu: HOME/MENU (label differs by device)
• Open menu: MOD + X
• Toggle FPS display: MOD + Y
• Load state: MOD + L1
• Save state: MOD + R1
• Toggle slow-motion: MOD + L2
• Toggle fast-forward: MOD + R2
• Toggle current shader: MOD + D-Pad UP
• Cycle state slots: MOD + D-Pad LEFT/D-Pad RIGHT

• MOD = MENU (SELECT on devices with no MENU key)
• screenshot = MOD + A
• Quit = MOD + B
• Open menu = MOD + X
• Toggle FPS = MOD + Y
• Cycle state slots = MOD + left/right
• Save state = MOD + R1
• Load state = MOD + L1
• Cycle screen layouts = MOD + up/down
• change primary screen = MOD + L2
• FF hold = R2
• FF toggle = MOD + R2
• Tap stylus = L2 or L3

Zero-stick devices:

• Use D-pad as stylus = hold R2
• no FF hold button

One-stick devices:

• stylus control is on left stick

Two-stick devices:

• stylus control is on right stick
• left stick mirrors d-pad

• The classic spruce theme is minimalistic, but we include around a dozen default themes for you to try.
• For additional themes, you can either download additional themes from here and place the unextracted .7z archives into the Themes folder on your SD card, or you can use our Theme Garden app to browse the repository and install them over the air, directly onto your spruce device!
• We are always seeking new themes, and would love to feature your artwork! If you are interested in contributing a theme, please reach out! There has also been some preliminary work on a Theme Guide to help get you started.

spruceOS is a volunteer community effort, with a very fluid team structure. It would be impossible to list everyone who has contributed to the project, code or otherwise. Here are some contributors from recent development cycles, in alphabetical order:

• Arkun
• Chrisj951 - Discord @chrisbastion
• Hario
• KitFox
• KMFDManic
• Lonko
• Mike Kendall
• Noxwell
• RDWilliamson
• Ryan "Ry" Sartor
• SundownerSport

• Tenlevels: Starting spruce, making kickass themes and getting the A30 where it deserves to be! Spruce would never have existed without him, we are eternally grateful to the long hours and dedication he put in. Thanks buddy!
• Shauninman: Constant help, tech support, and inspiration (plus all the code we stole from him :D).
• MustardOS Team: we borrowed kind of a lot from you guys... thank you!
• Christian Haitian: updated graphics driver for Miyoo Flip; some libretro cores.
• Knulli and the rest of the Open Handheld Collective for amazing collaboration and sharing. It takes a village!
• XanXic: lots of organizational improvements; designing the OTA and EZ Updaters; and so much more!
• Onion Team: guidance and inspiration.
• Steward, trngaje: Custom DraStic versions.
• XK: Custom SDL2 versions for the Miyoo Mini family of devices
• KMFDManic: Building and testing new cores (N64 F^%$ Yeah!).
• Hoo: Testing and encouragement.
• Metallic77: Custom lightweight shaders for the A30, and Flycast tweaks.
• Russ from RGC: His YouTube channel is an inspiration.
• Icons8.com for the logo, icons and their genrosity in giving us expanded access to icons for this project.
• Miyoo, TrimUI, and Anbernic for sending us development units.
• All past and present Team Members!
• Our wonderful nightly testers, who have provided tons of helpful feedback, bug reports, and comeradery!

THANK YOU TO THE AMAZING RETRO HANDHELD COMMUNITY!!

Some of our contributors use AI to help code, as is the industry standard. The spruceUI organizations’s policy on AI use is that we will always judge potential contributions based on the code’s quality rather than who wrote it, or how.

Click here for a table of supported systems and file extensions.