01. Installation Instructions - spruceUI/spruceOS GitHub Wiki

SpruceOS 4.0.0 updates are coming to the wiki!

I'll be slowly adding and editing things please be patient as we get ready for the upcoming release of spruceOSV4.0

You can find the latest Nightly releases here https://github.com/spruceUI/spruceOSNightlies

Devices supported by the Nightly are: Miyoo A30, Miyoo Flip, Miyoo Mini Flip, TrimUI Brick (and Hammer), TrimUI Smart Pro and the TrimUI Smart Pro S.

They all use the same microSD card and you can switch the card freely between them!

-Sun

You will need:

  1. A new, branded microSD card, purchased from a reputable source (tenlevels recommends Samsung Evo Select).
  2. A high quality branded microSD card reader. DO NOT TRY TO USE USB MASS STORAGE MODE.
  3. 7Zip installed on your computer, it is free and really great!
  4. Download and install Rufus on Windows. Tenlevels actually uses AOEMI Partition Assistant instead but Rufus is super simple, popular and effective.

After an installation or update, power on the device and power it off and on again.

Spruce Installation Instructions:

Windows:

Formatting your microSD card:

  1. Insert your microSD card into your computer.
  2. Open Rufus.
  3. Select your card from the top most drop down menu.
  4. Change “Boot selection” to “Non bootable”.
  5. Change “File system” to FAT32.
  6. If you want, name the drive in “Volume label”.
  7. Press Start, there will be a pop-up warning you that all data will be lost, press OK.

Installation:

  1. In File Explorer, navigate to the downloaded “spruce.vX.X.zip” file.
  2. Right-click it, select “Extract all...” and extract the contents directly onto your microSD card.
  3. When this is complete, right click on the microSD card and select “Eject” to safely remove it.
  4. Insert the microSD card into the device and turn it on.

Mac:

Formatting your microSD card:

  1. Insert your microSD card into your Mac.
  2. Open Disk Utility.
  3. Select your microSD card.
  4. At the top of the window, click Erase.
  5. Name the card.
  6. Under Format select MS-DOS (FAT32).
  7. Click Erase.
  8. When finished, click Done

Installation:

  1. Open Finder.
  2. SHIOW HIDDEN FILES by pressing Command + Shift + . (Period).
  3. Navigate to the “spruce.vX.X.zip” and extract it.
  4. Copy/Paste the entire extracted contents onto your microSD card.
  5. Use an App like CleanEject (https://www.javawa.nl/cleaneject_en.html) to eject and clean the junk .dot files from your microSD card.

Chrome:

Formatting your microSD card:

  1. Insert your microSD card into your computer.
  2. Open the “Files” app.
  3. Navigate to your microSD card.
  4. Right-click (double finger tap) on your card.
  5. Select “Format device”.
  6. Name the card.
  7. In “Format” select FAT32.
  8. Click “Erase and Format”.
  9. Click the Eject icon to the right of the drive name and remove the card.
  10. Reinsert the card (mine bugged out on me if I didn't do this and renamed all the files adding a “ (1)” to the end).

Installation:

  1. In the “Files” app navigate to the downloaded “spruce.vX.X.X.zip” file.
  2. Open the file, this might take a second to load.
  3. Press Control+A to select all files.
  4. Right-click (double finger tap).
  5. Select “Copy”.
  6. Navigate to your microSD card (it will be blank).
  7. Right-click (double finger tap).
  8. Select “Paste”.
  9. When the files are done pasting, click on the Eject icon to the right of the drive name.
  10. Remove the microSD card and insert it into your A30.

Linux:

There are just too many distros to get into a lot of detail with Linux.

  1. Format your microSD card to FAT32, I used the standard disk utility on Ubuntu.
  2. Extract the “spruce.vX.X.X” file.
  3. Open the extracted folder and SHOW HIDDEN FILES.
  4. Copy and Paste the contents of the extracted folder onto the microSD card.
  5. When complete, eject the microSD card and insert it into your A30. Linux Note:

Ubuntu, at least for me, has the .Config and .Temp_Update folders hidden, you need these files.

Common issue!

The .tmp_update folder is very important and without it spruce just isn't going to work properly. If you are having issues, please check to see that this folder is present on your microSD card.

Your microSD card root should look like this after copying files onto it:

This will need updating when we cut a final 4.0 release.