twigUI

SpruceOS for the GKD Pixel 2

Installation

Caution

The installation process will wipe everything in your microSD card, make backups of any data you might want to preserve.

Automatic Installation

• You can use the new All-in-one installer tool!
• It downloads and flashes the latest TwigUI release and it available for Windows, Mac and Linux!
• Just be sure to select TwigUI from the available options.

Manual Installation

• Download balenaEtcher
• Download an install image from the releases page and extract the .img file.
• Remove the microSD card from your handheld and insert it into a microSD card reader.
• Run balenaEtcher, click on Flash from file and select the previously downloaded twigUI.img file.
• Click on Select target and select the microSD card previously inserted.
• Click on Flash! and wait for the process to finish.
• Once the flashing process is done remove the microSD card from the reader, insert it into your handheld and long press the power button to power it up.

Updating

There are two ways of updating to the latest release.

EZ Updater

• Download the twigUI_x.x.x_update.7z file from the latest release in the releases page.
• Copy/paste this file directly onto the root of your microSD card (DO NOT EXTRACT THIS FILE).
• Turn on your device.
• 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.

Manual

• Turn off your handheld and remove the microSD card
• Remove the microSD card from your handheld and insert it into a microSD card reader.
• Download an update image from the releases page and extract it.
• Open the ROMS partition (labeled as twigUI in windows) of your microSD card and remove everything except the following folders:
  • Roms
  • Saves
  • BIOS
  • Persistent
  • Collections
  • Themes
• Copy the extracted files from the update .7z file into the ROMS partition (labeled as twigUI in windows) of the microSD card.
• When prompted, allow the new files to replace the existing ones.
• Once the copying process is done remove the microSD card from the reader, insert it into your handheld and long press the power button to power it up.

Special thanks

• The spruceOS team
• christianhaitian for the emulator build scripts.
• cscribn for the docker container for the builds scripts.
• RetroGFX for guidance setting up the build scripts and some patches from UnofficialOS.