This release of UnofficialOS brings a bunch of updates to emulators and packages. RetroArch has been updated to 1.21 and cores brought up to date, along with the following stand alone emulators: GZDoom to g4.14.1, Hypseus-Singe to v2.11.5, FlyCast to 2.5 and Kronos to 2.7.0. Hatari and CEMU have been updated to current commits also. Moonlight, as well as Box86, Box64, and wine have been updated also, with Box86/64 being added to RK3326 devices. ScummVM has also been added to S922X units as well. Last but not least, all VPN and Cloud Sync packages have been brought up to date, including Rclone, Rsync, SyncThing, TailScale, ZeroTier-One, and Connman. Working on the RG-Arc units now, so hopefully support will be added soon.

Installation

Fresh Install

1. Download the proper *.img.gz for your device.
2. Extract the .img and flash the image to your microSD card using your favorite image writing tool (Balena Etcher, Raspberry Pi Imager, Win32 Disk Imager, dd etc.)

Upgrading Over the Air (OTA)

OTA Updating Is Supported In This Release If Using the 20250207 or Newer Release Of UnofficialOS

If your device has access to the internet you can update UnofficialOS directly from EmulationStation.

1. In EmulationStation open the main menu by pressing the "Start" button on your controller.
2. Select System Settings
3. Scroll to the System Update header and select Start Update

Upgrading Manually

Manual Upgrading Is Supported In This Release If Using the 20250207 or Newer Release Of UnofficialOS

If you device does not have access to the internet you can still update manually

1. Download the latest update (.tar) of UnofficialOS for your device from the releases page.
   • Make sure to download the correct .tar file for your device. For example; if you are installing UnofficialOS on a RG351P you would download the UnofficialOS-RK3326 file.
   • If you have any questions you can check the Device Support section to confirm which .tar you should download for your specific device.
2. Copy the update to your device's update share.
   • via SCP to /storage/.update
   • via Samba to "update"
3. Reboot the device, and the update will begin automatically.

Folder Structure for Bios And Games

The folder structure has changed from the root of SD2 to a single folder. The folders for these must now be in a folder named "roms". The folder structure for SD2 can be generated by using the "Create Game Directories" option under System Settings. If you have an existing SD2 with all the folders on the root of the card, just create the folder named "roms", and move the rest of the folders (bios, nes, snes, gb, etc) into this folder. If this is not done ES will not see your games.

IMPORTANT Known Bugs/Issues

Powkiddy RGB20 Pro

Currently there are no leds working when uOS is running. Charging led works if the unit is powered off. I'm working to fix this.

Powkiddy X55

This device has a few known issues.

1. Charge the unit while its turned on, not while its powered off or sleeping.
2. Plugging the power cable in with the unit off causes it to boot. This is normal right now for the unit to charge.
3. Powering down fully for more then a few minutes at a time resets the battery meter. This IS NOT drain, its a bad meter reading.
4. And last, sleeping the unit breaks sound.

What I have been doing currently is charging the unit to 100%, sleeping the unit when not in use, then I'll wake it and reboot when I want to use it. It still has very good battery life when sleeping, as I only lose between 5% and 10% battery daily. Not ideal I know, I'm working towards a fix.

X86_64

This build has some broken emulators, specifically:

1. CEMU
2. XEMU
3. Vita3K
4. PPSSPP Standalone

Odroid Go Advance

There is currently hotkey issues with this unit, specifically with PortMaster. Ports require a hard shutdown (not recommended).

Working for fixes on all mentioned issues and bugs. Please be patient, as it's only myself working on uOS at the moment. Any help/contributions would be greatly appreciated if you would like to help. Please report bugs/issues to the uOS discord here.

Changelog

The commits for this release can be viewed here in the pull request for this release. Another change that is important is the folder structure for the rom files and bios has changed. Please see above for instructions.