13. Using Apps - spruceUI/spruceOS GitHub Wiki

Here you will find all the apps that spruce currently contains, in alphabetical order.

scraper Boxart Scraper

Scrape box art for your games! Please note that not every system is currently supported, but most are!

You need to be connected to WiFi and have your RTC set correctly in order for this App to work. You can enable the "Sync Time/RTC with network" function in the Network tab of Advanced Settings to do this automatically.

It will skip any existing games with boxart already; it will not overwrite your old boxart!

bootlogo Boot Logo

Browse the images in the app choose one you like.

Select your choice to change your current boot logo to your newly selected one.

The logos included have been tested and work fine. The app will recognize a logo that does not meet the strict requirements needed of your device, and prohibit you from bricking your device.

NOTE: Using this app with logos other than the ones provided should be safe, but do so only at your own risk!

Thanks Shaun Inman for providing this app and 369px for enhancing it!

file File Management

This program (AKA Dingux Commander) can be used to navigate, view, edit, move, copy and delete files directly on your device.

firmwareupdate Firmware Updater

This App will automatically appear in your Apps section if your device is using an old Firmware version. It will walk you though the process step by step and you will be off to the races! Please update your Firmware!

iconfresh Game Nursery

Download and install free games over WiFi directly!

https://github.com/user-attachments/assets/7b03859c-af24-4653-968c-04babf109d71

icons8-data-transfer-70 GameSwitcher

This feature allows you to switch between games quickly and easily! Simply press and hold the Home button while in a game to open GameSwitcher. It is possible to switch this control in Settings so that tapping Home brings up GameSwitcher and holding Home brings up the In-Game Menu.

SpruceGameSwitcher

gamelist Miyoo Gamelist

This will scan every console subfolder for the gamelist.xml file and will generate a miyoogamelist.xml.

It cleans up and shortens game names.

It cleans up game names removing ( )'s and [ ]'s from appearing.

random Random Game

There are actually two versions of this App on spruce. One is in the App menu and the other is in the X menu in the Game list. Their function is extremely simple.

For the App version simply press A on it and it will boot a random game directly.

For the X Menu version press X while you are in the Game List (like you are changing core or CPU speed) and select Random Game. This will bring you to a random spot in the list giving you the option to boot the game or not.

retroarch Retroarch

This gives you access to Retroarch and lets you change settings etc. If you are not familiar with Retroarch you should not use this at all.

icons8-micro-sd-70 Samba

Samba is enables in Settings/Network Settings.

You will want to turn off the "Shutdown when idle..." options.

Windows:

  1. Connect your device to WiFi.
  2. Turn on Samba on your device.
  3. On your computer, click on the search bar by your menu icon (usually bottom of your screen).
  4. Type in run and hit enter. A box will pop up.
  5. Type in \\ip.add.re.ss (replacing it with your device’s IP address and press enter.
  6. A login window may pop up; use user: spruce and password: happygaming. You can check a box to have your computer remember these credentials so you don’t have to log in next time.
  7. Now a window should appear that allows you to access your SD card contents.

Mac:

Here's the Mac equivalent:

  1. Connect your device to WiFi.
  2. Turn on Samba on your device.
  3. On your Mac, click the Finder icon in your Dock.
  4. Press Cmd + K or go to the menu bar and select Go > Connect to Server.
  5. Type in smb://ip.add.re.ss (replacing it with your device's IP address) and click Connect.
  6. A login window will pop up; use user: spruce and password: happygaming.. You can check "Remember this password in my keychain" to avoid logging in next time.
  7. Now a Finder window should appear that allows you to access your SD card contents.

Linux:

  1. Connect your device to WiFi.
  2. Turn on Samba on your device.
  3. On your computer, open your File Manager (thunar, dolphin, nautilus, etc).
  4. In the address space type in smb://your_device_ip (replacing it with your A30’s IP address you found on the WiFi line of main settings or on the advanced settings network tab) and hit enter.
  5. A login window may pop up; use user: spruce and password: happygaming.
  6. You can check a box to have your computer remember these credentials so you don’t have to log in next time.
  7. Now a window should appear that allows you to access your SD card contents.

Note: On some Linux systems a additional package might be required, this is outside our scope but please be beware of this possibility.

expertappswitch Sapling Guide

A basic slideshow to highlight some basic features of spruce on the A30.

https://github.com/user-attachments/assets/08e26a30-e529-42fe-90e6-c81be2ea1543

SSH SSH

You will want to turn off the "Shutdown when idle..." options.

SSH (secure shell) gives a direct look into the Linux brain of your device. This is mostly only useful for devs and tinkerers, but it’s there if you’d like to take advantage of it (thanks FragBait79!).

Setup Instructions (Windows):

  1. Install PuTTY on your computer:

  2. Connect your device to WiFi, and make note of its IP address. Then, run the SSH app on your A30 to enable the service.

  3. Launch PuTTY. Type your device’s IP address into the box, and make sure SSH is checked.

  4. (Optional) You can save your IP for next time to make it quicker: just type “Carl!” or whatever in the “Saved Sessions” box and click Save.

  5. Click Open. A command line pops up, and you log in using username spruce and password happygaming. clackity hacker key noises “I’m in!”

Screenshot 2024-10-03 101301

syncthing Syncthing

Toggle this functionality using Settings/Network Settings.

Retro Game Corps has made an awesome guide for Syncthing! Find it here.

icons8-tree-planting-70 Theme Garden

Use this App while connected to WiFi to view and download the latest Themes!

sftpgo WiFi File Transfer

Toggle this functionality using Settings/Network Settings.

You will want to turn off the "Shutdown when idle..." options.

This allows you to manage your files wirelessly. You can upload, download, move and delete files all using your internet browser or FTP client.

IMPORTANT: For stable WiFi, update your firmware first!

Browser

  1. Select WIFI FILE TRANSFER in the App menu. It should now say "WIFI FILE TRANSFER - ON".

  2. Go to your Settings menu and look at the WiFi tab, it will show an IP address.

  3. In your internet browser type your IP address from step 4 followed by ":8080" and press Enter.

It should look like this: XXX.XXX.X.X:8080 or XX.X.X.XXX:8080.

user: spruce and password: happygaming.

In your browser, you will see a screen like this:

Screenshot 2024-12-16 152356

FTP Client

  1. Download and install your favorite FTP client. For example: FileZilla
  2. Connect to the IP address of your device on port 21. The username name and password is the same for both Browser and FTP (see above).

(Thanks Veckia and FragBait79!)