Home - spruceUI/spruceOS GitHub Wiki

spruce labeled

Welcome to the spruce Wiki!

"This Wiki will walk you through your first steps. It will get you up and running on the four most common operating systems. I am writing this as somebody that struggles with overly technical how-to guides. I have watched too many videos that just gloss over some very important yet basic steps that have created headaches for beginners like myself. We have a FAQ page with a lot of common issues.

Most importantly, I am writing this as somebody that is new to retro-handhelds, for people that are new to them as well. I want you to succeed in getting spruce working no matter how skilled you are with computers. Please feel free to reach out to me directly for help on either Reddit or Discord; @ me, u/ me or just send me a message."

-SundownerSport

What is spruce?

Spruce is not truly an operating system (OS). It is a modified version of the stock Miyoo OS that cleans up bloat, optimizes performance, focuses on aesthetics and ease of use. It is intended to be sleek, intuitive and efficient. Spruce is a community built software that is constantly evolving, if you would like to help out with development or have an idea that would make it better please let us know.

You will need:

  1. A new, branded microSD card, purchased from a reputable source.
  2. A high quality branded microSD card reader.
  3. Download and install Rufus on Windows. Rufus is super simple, popular and effective.

IMPORTANT NOTE FOR PEOPLE NEW TO THE HOBBY

THROW AWAY THAT STOCK CARD!

IT'S JUNK, THE GAMES ON IT ARE JUNK AND THE BIOS ARE JUNK!


Ports and Free Games

Check out our repository for Ports and Free Games https://github.com/spruceUI/Ports-and-Free-Games Here you can find ports for the A30 we've found or created. Files can be downloaded from the Individual Releases section. Some games are ready to run and others require you to supply files from your legally obtained PC versions of the game.

Ports can also be downloaded and found on the A30 itself using the Game Nursery app!

Themes

Spruce includes a few starter themes by default but more can be found on our Themes repo: https://github.com/spruceUI/Themes Themes come pre-7z'd and can just be placed into your /Themes folder on your SD card and Spruce will install it and make it available on start up.

We are always looking for new themes, if you're interested in making one check out our Theme Design Guide wiki entry.

Stock A30

We also have a backup of the Miyoo stock SD card for the A30. (With the roms and Bios removed) https://github.com/spruceUI/Miyoo-A30-StockCard

Version History

  • v1.0.0 - Released June 15, 2024
  • v1.0.1 - Released June 17, 2024
  • v1.2.2 - Released July 01, 2024
  • v1.3.0 - Released July 10, 2024
  • v1.3.5 - Released July 17, 2024
  • v1.4.0 - Released July 26, 2024
    • Quick resume game added
  • v1.4.1 - Released July 27, 2024
  • v1.4.2 - Released July 28, 2024
  • v1.4.3 - Released Aug 04, 2024
  • v2.0.0 - Released Aug 06, 2024
    • Spruce Team created!
    • Syncthing added
  • v2.1.0 - Released Aug 25, 2024
    • Boxart Scraper added
    • Wifi file transfer added
  • v2.2.0 - Released Sep 08, 2024
    • Per-game launch settings added
  • v2.2.1 - Released Sep 08, 2024
  • v2.2.2 - Released Sep 12, 2024
  • v2.3.0 - Arbor - Released Sep 25, 2024
    • Backup/Restore created
    • Spruce codebase overhaul
  • v3.0.0 - Bark - Released Nov 6, 2024
    • Game switcher added
    • Advanced Settings added
    • Samba added
    • Syncthing checker added
    • Theme unpacker added
    • EZ Updater added
    • Firmware Updater added
    • Keymon replaced, home and power now under spruce control
    • Shutdown when idle mastered
    • Spruce codebase overhaul finished
  • v3.0.1 - Arid Bark - Released Nov 12, 2024
  • v3.1.0 - Chloroplast - Released Nov 30, 2024
    • OTA's added
  • v3.2.0 - Dripline - Released Dec 15, 2024
    • Game Nursery added
    • Simple mode added
    • Onboard help guide added
  • v3.3.0 - Evergreen - Released Jan 12, 2025
    • Perfect overlays
    • Network services page
  • v3.3.1 - Absolute Evergreen - Released Jan 15, 2025