Releases: RetroGFX/UnofficialOS
20260515
This release of UnofficialOS brings new and updated cores and emulators, support for the Anbernic RG ARC S/D, R36T and R36T Max. The RG ARC-D is confirmed working with android (stock/GammaOS Core) on the emmc. BigPEmu has been added to all units, as a stand alone Atari Jaguar emulator. PortMaster has been updated to the latest beta since it contains uOS specific fixes. Special thanks to @christianhaitian and @ROCKNIX for the BigPEmu references, @kloptops for the speedy merge of my PortMaster commits, and @KitFox618 for the help testing.
New Device Support
- Anbernic RG ARC-S/D
- AISLPC R36T/R36T Max - overlays
New Cores and Emulators
- gearlynx - Atari Lynx
- geargrafx - PC Engine/CD, TurboGrafx-16/CD, Super Grafx
- geolith - Now Supports Neo Geo CD
- BigPEmu v1221 - Atari Jaguar
Updated Cores and Emus
- PortMaster - 2026.05.04-1202
- PCSX2 - v2.7.321
- Vita3K - 3969 - Instructions
- RPCS3 - 0.0.40-19335 - Instructions
Fixes
- Fix Dolphin Rotaion - X55
- Fix Filemanager - X55
- RG ARC Retroarch/SA controls and remaps
- Device Specific Quirks for BigPEmu Config Files
Installation
Fresh Install
- Download the proper *.img.gz for your device.
- 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/R45H/R46H, MagicX XU Mini M, Kinhank K36, A10 Mini, 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 |
| Anbernic RG ARC-S/D | RK3566-BSP-RGARC |
| Powkiddy X55 | RK3566-BSP-X55 |
| Anbernic RG552 | RK3399 |
| Gameforce Ace, Orange Pi 5/5 Plus, Radxa Rock 5A/5B/5B Plus, Indiedroid Nova, NanoPi R6C/R6S (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.
- In EmulationStation open the main menu by pressing the "Start" button on your controller.
- Select System Settings
- 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
- 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-RK3326file. - If you have any questions you can check the Device Support section to confirm which .tar you should download for your specific device.
- 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
- Copy the update to your device's update share.
- via SCP to
/storage/.update - via Samba to "update"
- via SCP to
- 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/R45H/R46H, MagicX XU Mini M, Kinhank K36, A10 Mini, 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 |
| Anbernic RG ARC-S/D | RK3566-BSP-RGARC |
| Powkiddy X55 | RK3566-BSP-X55 |
| Anbernic RG552 | RK3399 |
| Gameforce Ace, Orange Pi 5/5 Plus, Radxa Rock 5A/5B/5B Plus, Indiedroid Nova, NanoPi R6C/R6S (must set dtb in extlinux.conf) | RK3588 |
| Hardkernel Odroid Go Ultra/N2/N2L, Powkiddy RGB10 Max 3 Pro | S922X |
IMPORTANT Known Bugs/Issues
Clones Units
Currently some clone units currently have no LEDs working when uOS is running.
Powkiddy X55
This device has a few known issues.
- Charge the unit while its turned on, not while its powered off or sleeping.
- Plugging the power cable in with the unit off causes it to boot. This is normal right now for the unit to charge.
- 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.
- 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
20260414
This release of UnofficialOS brings new and updated cores and emulators, support for the A10 Mini with onboard wifi and also a new overlay for 60Hz. DuckStation has been updated to the latest mini appimage on all units but RK3566-BSP/X55. There has been a new chart added to the wiki with specific bios paths. See below for the list of changes. Special thanks to @recioalex , @ROCKNIX, @lcdyk0517 for the A10 Mini help, and @KitFox618 for the help testing.
New Device Support
- A10 Mini with Wifi/60Hz Panel - Overlays
New Cores and Systems
- GB/GBC/GBA/NDS - SkyEmu libretro
- GBA Video
- Nintendo 64 Disk Drive
Updated Cores and Emus
- PPSSPP SA/lr - 1.20.3
- PortMaster - 2026.04.01-1426
- ScummVM SA/lr - 2026.2.0
- DuckStation Mini - 0.1-10495
- PCSX2 - v2.7.248
- Vita3K - 3949 - Instructions
- RPCS3 - 0.0.40-19192 - Instructions
Fixes
- Fix R45H/R46H Wifi
- Fix Vita3K Scanning and Game/FW Installation
- RPCS3/Vita3K/XEMU/AetherSX2 Tools Script Fixup
- Fix Odroid Go Super PPSSPP Controls
- PPSSPP Fixes for Cheats
- Wasm4/Vita3K/RPCS3 - ES Settings
- Bump/Fix TIC-80
- Updated Wiki
Installation
Fresh Install
- Download the proper *.img.gz for your device.
- 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/R45H/R46H, MagicX XU Mini M, Kinhank K36, A10 Mini, 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/5 Plus, Radxa Rock 5A/5B/5B Plus, Indiedroid Nova, NanoPi R6C/R6S (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.
- In EmulationStation open the main menu by pressing the "Start" button on your controller.
- Select System Settings
- 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
- 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-RK3326file. - If you have any questions you can check the Device Support section to confirm which .tar you should download for your specific device.
- 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
- Copy the update to your device's update share.
- via SCP to
/storage/.update - via Samba to "update"
- via SCP to
- 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/R45H/R46H, MagicX XU Mini M, Kinhank K36, A10 Mini, 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/5 Plus, Radxa Rock 5A/5B/5B Plus, Indiedroid Nova, NanoPi R6C/R6S (must set dtb in extlinux.conf) | RK3588 |
| Hardkernel Odroid Go Ultra/N2/N2L, Powkiddy RGB10 Max 3 Pro | S922X |
IMPORTANT Known Bugs/Issues
Clones Units
Currently some clone units currently have no LEDs working when uOS is running.
Powkiddy X55
This device has a few known issues.
- Charge the unit while its turned on, not while its powered off or sleeping.
- Plugging the power cable in with the unit off causes it to boot. This is normal right now for the unit to charge.
- 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.
- 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
20260318
This release of UnofficialOS brings updated cores and emulators, new RK3588 sbc's, a few added emulators on different chipsets, and a bunch of bug fixes. The Azahar libretro core has been added to AMD64 and S922X, and PPSSPP libretro has beed added to all devices. The RK3588 image has been fixed and tested on the Indiedroid Nova. See updated device docs and the wiki. Special thanks to @christianhaitian, @ROCKNIX, @lcdyk0517 and kk for the driver fix for enable-gpio, and @KitFox618 for the help testing.
New RK3588 Devices
- Orange Pi 5 Plus
- Rock 5B Plus
- Rock 5A
- Indiedroid Nova
- NanoPi R6C
- NanoPi R6S
- (Previously/Still Supported - Rock 5B, Gameforce Ace, Orange Pi 5)
New Cores
- 3DS - Azahar libretro - AMD64/S922X
- PSP - PPSSPP libretro - All Units
Updated Cores and Emus
- PPSSPP SA/lr - 1.20.2
- PortMaster - 2026.03.09-2312
- ScummVM SA/lr - 2026.1.0
- YabaSanShiro SA - 1.11beta3
- PCSX2 - v2.7.170
- XEMU - v0.8.134
Fixes
- Fix Mesa on RK3588
- Fix ScummVM Scanning
- add enable-gpio to dsi driver
- Mednafen - control fixes
- Bump/Fix Hatari SA
- PCSX2/AetherSX2/XEMU - ES Settings
Installation
Fresh Install
- Download the proper *.img.gz for your device.
- 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/R45H/R46H, 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/5 Plus, Radxa Rock 5A/5B/5B Plus, Indiedroid Nova, NanoPi R6C/R6S (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.
- In EmulationStation open the main menu by pressing the "Start" button on your controller.
- Select System Settings
- 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
- 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-RK3326file. - If you have any questions you can check the Device Support section to confirm which .tar you should download for your specific device.
- 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
- Copy the update to your device's update share.
- via SCP to
/storage/.update - via Samba to "update"
- via SCP to
- 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/R45H/R46H, 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/5 Plus, Radxa Rock 5A/5B/5B Plus, Indiedroid Nova, NanoPi R6C/R6S (must set dtb in extlinux.conf) | RK3588 |
| Hardkernel Odroid Go Ultra/N2/N2L, Powkiddy RGB10 Max 3 Pro | S922X |
IMPORTANT Known Bugs/Issues
Clones Units
Currently some clone units currently have no LEDs working when uOS is running.
Powkiddy X55
This device has a few known issues.
- Charge the unit while its turned on, not while its powered off or sleeping.
- Plugging the power cable in with the unit off causes it to boot. This is normal right now for the unit to charge.
- 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.
- 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
20260212
This release of UnofficialOS brings updated cores and emulators, new systems, a few added emulators on different chipsets, and a couple new devices. Dolphin stand alone (don't expect miracles) and Mednafen have been added to RK3566-BSP, and MelonDS stand alone to S922X. See updated device docs here. Special thanks to @christianhaitian, @ROCKNIX, @lcdyk0517 and kk for the driver fix for the new panel, and @KitFox618 for the help testing.
New Devices
- R36 Plus - overlays here
- R46H/R45H/R40XX/R40XX Pro Max - overlay here
- The 5 devices above share the R36S dtb - directions
New Systems
- DSiWare - MelonDS-SA/MelonDSDS
- WiiWare - Dolphin
- Windows - Box86/64/Wine
- MegaDrive Hacks - GenesisPlusGX/PicoDrive/Mednafen
Updated Cores and Emus
- All idTech cores updated
- PortMaster - 2026.01.19-0955
- Box86/64
- Wine - 11.0 Vanilla
Fixes
- Direct Boot/Bios Settings in ES and Tools Launcher For MelonDS
- Dolphin Bios Settings in ES - /roms/bios/GC/(USA/JAP/EUR)/IPL.bin
- Fix MoonLight QT Compiling
- Remove R3xS/RGB20 Inverted LED Quirk
- Fix Drastic Menu for Units Without Menu Button
Installation
Fresh Install
- Download the proper *.img.gz for your device.
- 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.
- In EmulationStation open the main menu by pressing the "Start" button on your controller.
- Select System Settings
- 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
- 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-RK3326file. - If you have any questions you can check the Device Support section to confirm which .tar you should download for your specific device.
- 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
- Copy the update to your device's update share.
- via SCP to
/storage/.update - via Samba to "update"
- via SCP to
- 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
Clones Units
Currently some clone units currently have no LEDs working when uOS is running.
Powkiddy X55
This device has a few known issues.
- Charge the unit while its turned on, not while its powered off or sleeping.
- Plugging the power cable in with the unit off causes it to boot. This is normal right now for the unit to charge.
- 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.
- 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
20260113
This release of UnofficialOS brings new and updated cores and emulators, and a bunch of bug fixes. Boot time has been fixed and is significantly faster, especially on the weaker chipsets. BBC Micro has been added, along with id Tech Systems, which includes support for Doom, Quake, and Wolfenstein games (18 games total, 23 on AMD64). R36 Ultra ES switch is fixed. Forcepack is now an ES option, and is off by default, which fixes some graphical/performance issues. Clone users please see the updated directions here. These are important steps for these units, so please review this wiki page. Special thanks to @christianhaitian, @ROCKNIX, @lcdyk0517, @KitFox618, @Sundownersport and @chriscromer.
New Emulators and Cores
- RetroArch 1.22.2
- PortMaster 2026.01.11-0437
- Flycast Stand Alone 2.6
- BBC Micro - b2 core see here
- JAVA - freej2me-plus
- idtech Systems - directions
Bug Fixes
- Fixed boot times/hangs
- Only scan top ports directory
- PPSSPP default configs
- Flycast SA default mappings
- gpsp added to gba hacks
- R36 Ultra ES switch
- Made forcepack optional (per system/per game)
Installation
Fresh Install
- Download the proper *.img.gz for your device.
- 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.
- In EmulationStation open the main menu by pressing the "Start" button on your controller.
- Select System Settings
- 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
- 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-RK3326file. - If you have any questions you can check the Device Support section to confirm which .tar you should download for your specific device.
- 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
- Copy the update to your device's update share.
- via SCP to
/storage/.update - via Samba to "update"
- via SCP to
- 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
Clones Units
Currently some clone units currently have no LEDs working when uOS is running.
Powkiddy X55
This device has a few known issues.
- Charge the unit while its turned on, not while its powered off or sleeping.
- Plugging the power cable in with the unit off causes it to boot. This is normal right now for the unit to charge.
- 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.
- 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
20251215
This release of UnofficialOS brings fixed and updated cores and emulators, a bunch of bug fixes, and R36 Ultra support. Be aware that only the v1 Ultra has LED stick support at the moment. Clone users please see the updated directions here. These are important steps for these units, so please review this wiki page. Special thanks to @Pretz for the G350 PR, @KitFox618 and @Sundownersport for the help with testing.
R36 Ultra Bug Fix
I apologize to the users of the Ultra, there was a tiny bug in the current stable that stopped the device switches from showing in EmulationStation, which will break ota updates on this unit. This file can be downloaded and placed in the root on the partition where the boot.ini is, the overlay folder etc. Make sure its placed where the boot.ini, dtb files are and not in the overlays folder. With this file, ota updates will succeed, and the switch can be flipped next update. Thanks, and sorry for the inconvenience. As I don't have a unit to test, I missed this.
New Supported Devices and Features
- R36 Ultra (LED sticks work on v1) See Wiki Above
- EmulationStation Clone Device Switch for R36 Ultra
- Added Per Device Docs back / fixed building
Bug Fixes
- Fixed Webtool for MyMini Overlays
- BatleXP G350 - fixed Menu button thanks to @Pretz
- BatleXP G350 - fixed Drastic and PPSSPP to open menu with M key
- Game Console R36S - fixed PPSSPP to open menu with M key
- Xifan MyMini - fixed LED joystick color and added flow option, fixed ppsspp/drastic configs
- Xifan XF35H / XF40H - fixed LED joystick color
- G350 / R36S - Fixed gamecontrollerdb.txt
- Removed AdvanceMame and gbsp from ES emu options
- Fixed TIC-80 / added savestates
- Fixed vbam
- Misc build fixes
Installation
Fresh Install
- Download the proper *.img.gz for your device.
- 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.
- In EmulationStation open the main menu by pressing the "Start" button on your controller.
- Select System Settings
- 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
- 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-RK3326file. - If you have any questions you can check the Device Support section to confirm which .tar you should download for your specific device.
- 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
- Copy the update to your device's update share.
- via SCP to
/storage/.update - via Samba to "update"
- via SCP to
- 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
Clones Units
Currently some clone units currently have no LEDs working when uOS is running.
Powkiddy X55
This device has a few known issues.
- Charge the unit while its turned on, not while its powered off or sleeping.
- Plugging the power cable in with the unit off causes it to boot. This is normal right now for the unit to charge.
- 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.
- 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
20251110
This release of UnofficialOS brings new and updated cores and emulators, a bunch of LED and bug fixes, and support for the A10 Mini. There have been switches added to ES for clone units with LED sticks, and OTA updates have also been fixed on these units. Clone users please see the updated directions here. These are important steps for these units, so please review this wiki page. New libretro cores have been added for the GameTank retro console. The overlays for the A10 Mini can be found in the mipi-panel repo. Special thanks to @TheGammaSqueeze for the A10 Mini screen timings, @ROCKNIX for the quirk references for the RGB20 Pro, @lcdyk0517 for the help with the LED sticks, @den1703 for the K36 PR, @anthonycaccese for the GameTank art, and @Sundownersport and @KitFox618 for all the help adding and testing GameTank.
New Supported Devices and Features
- A10 Mini (overlays can be found here)
- SDL2 2.32.10
- EmulationStation Clone Device Switches for OTA
New Cores
- gametank
- gametank32
Bug Fixes
- BatleXP G350 - fixed LEDs
- RGB20 Pro - fixed LEDs
- Xifan MyMini - fixed LED joystick
- Xifan XF35H / XF40H - fixed LED joystick
- Kinhank K36 - fixed LEDs and headphone detection
- Misc build fixes
Installation
Fresh Install
- Download the proper *.img.gz for your device.
- 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.
- In EmulationStation open the main menu by pressing the "Start" button on your controller.
- Select System Settings
- 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
- 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-RK3326file. - If you have any questions you can check the Device Support section to confirm which .tar you should download for your specific device.
- 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
- Copy the update to your device's update share.
- via SCP to
/storage/.update - via Samba to "update"
- via SCP to
- 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
Clones Units
Currently some clone units currently have no LEDs working when uOS is running.
Powkiddy X55
This device has a few known issues.
- Charge the unit while its turned on, not while its powered off or sleeping.
- Plugging the power cable in with the unit off causes it to boot. This is normal right now for the unit to charge.
- 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.
- 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
20251005
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
- Download the proper *.img.gz for your device.
- 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.
- In EmulationStation open the main menu by pressing the "Start" button on your controller.
- Select System Settings
- 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
- 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-RK3326file. - If you have any questions you can check the Device Support section to confirm which .tar you should download for your specific device.
- 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
- Copy the update to your device's update share.
- via SCP to
/storage/.update - via Samba to "update"
- via SCP to
- 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.
- Charge the unit while its turned on, not while its powered off or sleeping.
- Plugging the power cable in with the unit off causes it to boot. This is normal right now for the unit to charge.
- 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.
- 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
20250829
This release of UnofficialOS brings new and updated cores and emulators, several bug fixes, and updated graphics packages.
New Cores
- bsnes-mercury-accuracy - SNES/SFC
- bsnes-mercury-balanced - SNES/SFC
- doublecherrygb - GB/GBC
- melonds-ds - NDS
- wasm4 - Fantasy Console
- geolith - NEOGEO (all units except x86)
- Play! - PS2 (x86)
Graphic Driver Updates
- SDL2 - 2.32.8
- glslang - 15.1.0
- vulkan-headers/loader/tools - 1.4.317
- spirv-headers/tools
- Mesa - 24.3.4
- libdrm - 2.4.125
- wayland-protocols - 1.44
Bug Fixes
- Fixed RK3399 (rg552) controls
- Patched RK3326/RK3326-CLONE for Moonlight and Hardware/Suspend options in ES
- Fixed Hypseus-Singe controller detection issues
- X86 broken emus seem fixed, but only the gui was tested
- Portmaster compatibility is way better then before, on mainline units especially
- Bumped meson and various build fixes (setenv/device-root related)
Installation
Fresh Install
- Download the proper *.img.gz for your device.
- 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/MP, Hardkernel Odroid Go Advance/Super, Powkiddy RGB10/RGB20S/V10, MagicX XU10 | RK3326 |
| BatleXP G350, GameConsole R33S/R35S/R36S, 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.
- In EmulationStation open the main menu by pressing the "Start" button on your controller.
- Select System Settings
- 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
- 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-RK3326file. - If you have any questions you can check the Device Support section to confirm which .tar you should download for your specific device.
- 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
- Copy the update to your device's update share.
- via SCP to
/storage/.update - via Samba to "update"
- via SCP to
- 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/MP, Hardkernel Odroid Go Advance/Super, Powkiddy RGB10/RGB20S/V10, MagicX XU10 | RK3326 |
| BatleXP G350, GameConsole R33S/R35S/R36S, 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
Clone Devices With Single Sticks
Right now there are issues with single stick units, we are working to fix this while we wait for our development units to arrive.
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.
- Charge the unit while its turned on, not while its powered off or sleeping.
- Plugging the power cable in with the unit off causes it to boot. This is normal right now for the unit to charge.
- 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.
- 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 for fixes on 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
20250802
This release of UnofficialOS brings the usual updated cores and emulators, along with support for the BatleXP G350, and numerous RK3326 bug fixes. PPSSPP had been bumped to 1.19.3, along with CEMU, Hatari, and Hypseus-Singe. Bug fixes include fileman being fixed for clones, updated controls on the R36S units (specific stand alone emulator fixes include Drastic, PPSSPP and Mupen64 mappings), and a V2 .dtb for specific clones with audio issues (please see wiki for instructions). The units that I've seen with this issue are the Batman clones (T16Max, S600, H50Pro), the R36S clone units, and the R36Ultra. There may be more, but these are the units that I'm aware of right now. The BatleXP also has specific instructions that need to be followed (please see here for instructions). Special thanks to @christianhaitian for the G350 dev unit, bsp .dts and joystick driver rotation code.
Installation
Fresh Install
- Download the proper *.img.gz for your device.
- 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/MP, Hardkernel Odroid Go Advance/Super, Powkiddy RGB10/RGB20S/V10, Magicx XU10 | RK3326 |
| BatleXP G350, GameConsole R33S/R35S/R36S, 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.
- In EmulationStation open the main menu by pressing the "Start" button on your controller.
- Select System Settings
- 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
- 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-RK3326file. - If you have any questions you can check the Device Support section to confirm which .tar you should download for your specific device.
- 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
- Copy the update to your device's update share.
- via SCP to
/storage/.update - via Samba to "update"
- via SCP to
- Reboot the device, and the update will begin automatically.
Update Package 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/MP, Hardkernel Odroid Go Advance/Super, Powkiddy RGB10/RGB20S/V10, Magicx XU10 | RK3326 |
| BatleXP G350, GameConsole R33S/R35S/R36S, 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
Clone Devices With Single Sticks
Right now there are issues with single stick units, we are working to fix this while we wait for our development units to arrive.
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.
- Charge the unit while its turned on, not while its powered off or sleeping.
- Plugging the power cable in with the unit off causes it to boot. This is normal right now for the unit to charge.
- 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.
- 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:
- CEMU
- XEMU
- Vita3K
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 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