02. Updating to the Latest Release - spruceUI/spruceOS GitHub Wiki

Important note for spruceV4.0!

  • Due to the crazy high number of changes since v3.3.2 we recommend a manual update or a fresh install for updating to 4.0.

Updating to the Latest Release:

Updating will allow you to carry over any Save, ROM and BIOS files you have already written onto your microSD card vastly shortening the time required versus a full fresh installation. This entire process will only take a few minutes.

Spruce Installer App

You can use our PC app to update your spruce install!

Simply check the update box before pressing install and it will handle everything for you.

This is a HARD MANUAL UPDATE and will not backup or restore your custom settings.

Find the latest release of this app for your computer here.

EZ Updater

Please do not do this for jumping from 3.3.2 to 4.0.0

  1. Download the "spruceVx.x.x.7z" from the Latest Release or from the Nightly repo.
  2. Copy/paste this file directly onto the root of your microSD card. DO NOT EXTRACT THIS FILE
  3. Turn on your device.
  4. Go to the "Apps" section and find the "EZ Updater" app and click on it.

It will go through the update process automatically! After it runs and a successful backup of your data it will update and shutdown your device. All you need to do is turn it back on and you're on the latest version of Spruce. It is as EZ as that!

Manual Update Instructions

If you wish to manually update or something went horrifically wrong with your auto update process these steps can be followed to manually update.

There are too many possible configuration changes possible to have this process preserve custom settings for advanced users.

Spruce is intended to be simple and accessible to beginners, advanced users with lots of changes should proceed with caution or just accept that you might need to redo your custom settings.

  1. Download the latest spruce release.

(optional) Copy and save back ups of a few things if not using Spruce Backup, see below.

  1. On your microSD card DELETE EVERYTHING EXCEPT "Roms, Saves, Persistent, Collections and BIOS".

  2. Open File Explorer and navigate to the latest release .7z.

  3. You must use 7Zip to extract it (windows breaks things).

  4. Extract it onto your computer NOT directly onto your microSD card.

  5. Making sure to show hidden files such as .tmp_update, copy and paste the entire contents onto your microSD card.

  6. When prompted, allow the new files to replace the existing ones.

(optional). Paste your locally saved files back in.

  1. After this has finished you can eject the microSD card from your computer an insert it into your device.

(optional) If you have a backup file, run the Spruce Restore app to have spruce automatically set it up.

replace

Important Note:

The .config and .tmp_update files might be hidden. YOU MUST SHOW HIDDEN FILES.

Files to Back Up if you want

PPSSPP Saves and configs:

.config/ppsspp/PSP/SAVEDATA

.config/ppsspp/PSP/SYSTEM

Syncthing configuration:

spruce/bin/Syncthing/confg

NDS Saves:

Emu/NDS/backup

Emu/NDS/savestates

RetroArch config:

RetroArch/retroarch.cfg

Custom themes

Themes/Any_Theme_Folder/