FAQ - spruceUI/spruceOS GitHub Wiki

I try to help as many people as I can to get spruce working for them. I have seen a lot of the same problems again and again and I want to share these with you all.


  • Please make sure you have the latest spruce release installed. Here is how to update.

  • There is a new firmware available that fixes WiFi! Please update your firmware!

  • Please make sure you have shown Hidden Files during the install, the ".config" and ".tmp_update" are essential for spruce to function.

  • Try a different microSD card! This often fixes peoples problems. There are counterfeits and just generally bad cards out there. You can try the SD card fix on the Unbricking/Firmware page but if this doesn't solve it I cannot really help you.

  • After adding games, go to Apps and run "Emu Fresh". Its a one stop shop and will auto populate your systems as well as refresh roms.

1. Why is my Games menu empty even though I already added games?

You need to run the App Emu Fresh, it will refresh your ROMs and auto populate your Games menu.

2. How do I add background music?

In each theme folder there is a "sound" folder, select your and replace the "bgm.mp3" with your own. You must rename the new file to "bgm.mp3"

3. How do I add new themes?

You can easily copy+paste in themes from the stock MiyooOS or Onion into the "Themes" folder on the root of the microSD card. Onion themes are not 100% compatible with spruce.

tenlevels got his start as a Thememaker, we are always interested in people contributing with new themes!

4. I am having issues with my microSD card and I cant figure it out. How do I fix it?

Try this Formatting tool on "Quick" mode, then format to FAT32 and install spruce normally. Its working like MAGIC getting seemingly dead SD cards working again on the A30.

5. PPSSPP Retro Achievements login not working! I can't get a virtual keyboard up to login with my info.

This seems to be a common issue with PPSSPP across multiple devices. This Reddit post and comment talks about a workaround for it.