github RetroGFX/UnofficialOS 20251005

one day ago

This release of UnofficialOS brings new and updated cores and emulators, support for the MagicX XU Mini M and U8, and a few important changes. Now, the RK3326-CLONE image will default to the BatleXP G350. K36/Clone users please see the updated directions here. These are important steps for these units, so please review this wiki page. There has been Xtreme cores added for N64 and DC, which significantly improves performance on the weaker chipsets. A new 3DS and PS2 core have been added. The overlay for the MyMini controls has been fixed also. Special thanks to @KMFDManic for his work on the Xtreme cores, @Sundownersport and @KitFox618 for all the help adding and testing the new cores.

New Supported Devices

  • MagicX XU Mini M
  • U8 - Requires invert right stick and screen rotation 270 on the webtool

New Cores

  • ludicrousn64-xtreme32 - N64 32bit (default on rk3326/rk3566)
  • ludicrousn64-xtreme - N64
  • morpheuscast-xtreme32 - DreamCast/Atomiswave/Naomi 32bit (default on rk3326/rk3566)
  • panda3ds - 3DS (x86 and RK3588)
  • ps2 - PS2 (x86)

Bug Fixes

  • Removed on device Joystick Configuration Tool, it broke controls on some clones
  • Fixed overlay for the MyMini analog stick, can be downloaded here
  • Fixed N64/DC performance on rk3326 thanks to the Xtreme cores

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.)

Installation Image Downloads

Device/Platform Install Image
Anbernic Win600, AOKZOE A1 PRO, AYANEO 2/2S/AIR/PRO/PLUS, Atari VCS, Ayn Loki Zero/Max, GPD Win4/Max2 AMD64
Anbernic 351P/V/M, Hardkernel Odroid Go Advance/Super, Powkiddy RGB10/RGB20S/V10, MagicX XU10 RK3326
BatleXP G350, GameConsole R33S/R35S/R36S, MagicX XU Mini M, Kinhank K36, Clones These Units Must Follow Wiki Install Instructions RK3326-CLONE
Anbernic 353P/PS/V/VS/M/RG503, Powkiddy RGB10 Max 3/RGB20 Pro/RGB30/RK2023 RK3566-BSP
Powkiddy X55 RK3566-BSP-X55
Anbernic RG552 RK3399
Gameforce Ace, Orange Pi 5, Radxa Rock 5b, Indiedroid Nova (must set dtb in extlinux.conf) RK3588
Hardkernel Odroid Go Ultra, Powkiddy RGB10 Max 3 Pro S922X-Odroid_GOU
Hardkernel Odroid N2 S922X-Odroid_N2
Hardkernel Odroid N2L S922X-Odroid_N2L

Upgrading Over the Air (OTA)

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

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 below or 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.

Update Package Downloads

Device/Platform Update Package
Anbernic Win600, AOKZOE A1 PRO, AYANEO 2/2S/AIR/PRO/PLUS, Atari VCS, Ayn Loki Zero/Max, GPD Win4/Max2 AMD64
Anbernic 351P/V/M, Hardkernel Odroid Go Advance/Super, Powkiddy RGB10/RGB20S/V10, MagicX XU10 RK3326
BatleXP G350, GameConsole R33S/R35S/R36S, MagicX XU Mini M, Kinhank K36, Clone units RK3326-CLONE
Anbernic 353P/PS/V/VS/M/RG503, Powkiddy RGB10 Max 3/RGB20 Pro/RGB30/RK2023 RK3566-BSP
Powkiddy X55 RK3566-BSP-X55
Anbernic RG552 RK3399
Gameforce Ace, Orange Pi 5, Radxa Rock 5b, Indiedroid Nova (must set dtb in extlinux.conf) RK3588
Hardkernel Odroid Go Ultra/N2/N2L, Powkiddy RGB10 Max 3 Pro S922X

IMPORTANT Known Bugs/Issues

Powkiddy RGB20 Pro and Clones

Currently there are no leds working when uOS is running. Charging led works if the unit is powered off. We are 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.

Odroid Go Advance

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

Working on fixes for all mentioned issues and bugs. Please report bugs/issues to the uOS discord here.

Changelog

The commits and changes can be viewed here in the pull request for this release.

Donate

Love this project? Please consider supporting us on Ko-Fi

Don't miss a new UnofficialOS release

NewReleases is sending notifications on new releases.