spruceOS

• 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.

  

Features

• Custom Python based UI.
• Game Switcher: seamlessly switch between save states during gameplay.
• Autosave shutdown/resume: 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.

Download the latest version

• CLICK HERE FOR THE LATEST RELEASE

Need help?

• CLICK HERE TO SEE THE WIKI

What was done:

• Featuring an all new highly customizable Python based front end UI.
• All emulators and cores are pre-configured with performance considered.
• Emulator systems are automatically detected games and show in the Games menu.
• Advanced Settings App.
• Auto Save/Quick Shutdown + Resume feature.
• GameSwitcher App added.
• Multiple WiFi networks can be remembered.
• Automatic Firmware Updater App.
• Syncthing function added.
• Random Game App.
• Bootlogo App.
• Gamelist.xml App.
• Boxart Scraper App.
• WiFi File Transfer function.
• SSH.
• Samba.
• Backup/Restore Apps added.
• Auto-updater App added.
• Battery % shown in Main Menu.
• Auto Shutdown when idle function.
• Recents tab is optional.
• Performance and overclock adjustments are preset and adjustable.
• In-game menu matches that of the theme loaded.
• Imgs folders for box art are located inside each Rom folder.
• BIOS folder has been created on the root of SD card.
• Auto save state/load states enabled.
• LED Control functionality.
• Over The Air updates.

Installation

• 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.

All In One Installer

• 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!

UPDATING TO THE LATEST RELEASE

To update:

See our updating spruce Wiki page for more info

Controls and Hotkeys

In-game

• Quicksave/Shutdown/Resume: Hold POWER for 3 seconds*
• Game Switcher: Hold HOME for 3 seconds
• In-game menu (RetroArch/PPSSPP only): Tap HOME

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

RetroArch

New unified hotkeys configured for RetroArch and PPSSPP, updated to what is considered a 'common' layout and what is compatible with our new use of the HOME key

• Screenshot: SELECT + A
• Exit to MainUI: SELECT + B
• Open menu: SELECT + X
• Toggle FPS display: SELECT + Y
• Load state: SELECT + L1
• Save state: SELECT + R1
• Toggle slow-motion: SELECT + L2
• Toggle fast-forward: SELECT + R2
• Toggle current shader: SELECT + D-Pad UP
• Cycle state slots: SELECT + D-Pad LEFT/D-Pad RIGHT

Please do not adjust the RetroArch configurations unless you are already familiar with RetroArch's workings: removing or changing settings may cause games and/or controls to not work correctly. The Default settings are from Miyoo and will undo any modifications that have been done to the configurations for spruce.

Retroarch

• Please do not adjust the settings in Retroarch unless you are very familiar with it.
• Removing or changing settings may cause games or controls to not work correctly.
• The "Default" settings are from Miyoo and will remove all the custom configuration that has been done for spruce.

Themes

• Included are some default themes to choose from in Settings.
• Download from a wide variety of themes using the Theme Garden app!
• We are seeking out new themes and hoping to get some soon! If you are interested in contributing a theme please reach out!
• Initial work has began creating a Theme Guide

Credits and Thanks

• 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!
• Chrisj951: Creating the Python based UI that enabled us to get rid of MainUI. You turned a pipedream into reality.
• All past and present Team Members!
• Decojon: Auto Save/Quick Shutdown + Resume feature, MainUI patches, Keymon tweaks, Random Game Selector (X-menu).
• Shauninman: Help, support and Bootlogo function (and so much more!).
• MustardOS and team, we borrowed kind of a lot from you guys thank you (looking at you AntiKK, SCUMMVM)!
• christianhaitian for update graphics driver for Miyoo Flip
• Knulli and the rest of the Open Handheld Collective for amazing collaboration and sharing. It takes a village!
• Rayon and Cinethezs: Boxart Scraper App and tweaks.
• Cinethezs, Oscarkcau and tenlevels: Random Game App
• Ndguardian, XanXic, and XK9274: Syncthing App.
• Basecase (Stefan Ayala): Syncthing sync check on Shutdown/Startup
• Veckia9x and Fragbait79: WiFi File Transfer App.
• XanXic: spruceBackup and spruceRestore Apps, AutoUpdater App, organizational wizardry and so much more!
• Fragbait79: SSH App, RTC-Sync, network services tweaks and many other optimizations.
• Ry: Overhauled Emu folder, LibRetro ports and so much more.
• Oscarkcau: GameSwitcher, Advanced Settings App and general debugging, clean up and optimizations to SO MANY things.
• Cinethezs: LED App, show-battery-percentage, Credits App and so much more.
• Jim Gray: Retroarch removal from MainUI, sick jams and general inspiration.
• Onion Team: The heavy lifting finding the best cores to use with Miyoo and inspiration.
• Steward: Drastic.
• XK, Cinethezs, Ninoh-FOX and Steward: Pico-8 wrapper.
• TomatoOS: Huge resource for 64 bit bins and so much more!
• Sky_Walker: Avocado theme.
• KyleBing: Cozy theme.
• 369px: Theme Guide.
• Cobaltdsc4102: Building and enabling the chimerasnes core for SFC and additional cores for other systems.
• KMFDManic: Building and testing new cores (N64 F^%$ Yeah!).
• Onion and Darkhorse: Overlays.
• Axcelon: Cleaned up and organized Overlay and Filter directories (and bug finding).
• Hoo: Testing and encouragement.
• All of out Beta testers!
• SundownerSport: Team Lead, Wiki and testing and most of the GitHub related mistakes and blunders.
• Metallic77: Shaders and core adjustments.
• Supermodi064: Photos, testing and support.
• Aemiii91, tGecko and QuackWalks: Being awesome!
• 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 for sending us development units.

THANK YOU TO THE AMAZING MIYOO COMMUNITY!!

The Current Team (Alphabetical order):

• 369px
• Chrisj951 - Discord @chrisbastion
• Chris Cromer
• Cilantro
• Cobaltdsc4102
• Dandon
• Hario
• Kitfox
• Lonko
• Ry - Ryan Sartor
• SundownerSport

SUPPORTED GAME SYSTEMS

Amiga / Amstrad CPC / Arcade / Arduboy / (FBNEO & Mame 2003+) / Atari 800 / Atari 2600 / Atari 5200 / Atari 7800 / Atari Lynx / Bandai Sufami Turbo / Bandai WonderSwan & Color WS / Capcom Play System 1 / Capcom Play System 2 / Capcom Play System 3 / ColecoVision / Commodore 64 / Commodore VIC-20 / DOOM (PrBoom) / Fairchild Channel F / Famicom Disk System / FFPlay, Video & Music Player / Game Tank / Game & Watch / GCE Vectrex / Magnavox Odyssey 2 / Mattel Intellivision / Mega Duck / MS-DOS / MSX - MSX2 / NEC SuperGrafx / NE / TurboGrafx CD / NEC TurboGrafx-16 / Nintendo DS / Nintendo Entertainment System / Nintendo Game Boy / Nintendo Game Boy Advance / Nintendo Game Boy Color / Nintendo Pokemini / Nintendo Satellaview / Nintendo Super Game Boy / Nintendo Super Nintendo / Nintendo Virtual Boy / Nintendo64 / PICO-8 / Quake (Tyrquake) / ScummVM / Sega 32X / Sega CD / Sega Dreamcast / Sega Game Gear / Sega Genesis / Sega Genesis MSU / Sega Master System / Sega Saturn / Sega SG-1000 / Sharp X68000 / Sinclair ZX Spectrum / SNES MSU1 / SNK Neo Geo / SNK Neo Geo CD / SNK NeoGeo Pocket & Color NGP / Sony Playstation / Sony PSP / TIC-80 / VideoPac / Watara Supervision / Wolfenstein3D (ECWolf)

• N64/DC/Naomi/PSP/Saturn:

  -Consider these "BONUS". If any games play and you enjoy it, GREAT! Do not expect these systems to run smooth. Again... Bonus!

Interested in being a tester, or just hanging out? To provide feedback and speak with the development team please join our Discord server by clicking on the image below or using this link