๐ง โก OnionPlus beta 3: Open MainUI 1.0.4, plus bug fixes
๐งช Beta. This build is published as a pre-release: only devices on the beta OTA channel receive it. Stable installs stay on V4.4.0-beta-20260928 until it is promoted.
This build replaces the stock MainUI with Open MainUI 1.0.4 by @robcodedev. Open MainUI: https://github.com/robcodedev/onionos-mainui-opensource
OnionPlus is still a personal-use build. It is not a replacement for Onion and not an official release. I use it on my own Miyoo Mini Plus. It is based on Onion 4.4.0-beta, with Miyoo Mini Flip support ported from 4.5-dev, and runs on the Miyoo Mini, Mini+, Mini v4 and Mini Flip.
๐ฏ Why this build exists
Several of these bugs are also in official Onion. Fixes for them have sat around for a long time without being merged, and no official corrective build has shipped for them. OnionPlus is where I apply and test those corrections for personal use. Reports, patches and concrete proposals stay public, so the Onion team can take them if they want. The point is that the work is visible instead of sitting unreleased.
๐ Open MainUI replaces the stock MainUI
An open-source (GPL-3.0) rewrite of Miyoo's closed-source MainUI, installed on all three models (Mini 283, Mini+ 354, Flip 285), in both Expert and normal mode.
- ๐ Game lists (1.0.4): consoles whose
miyoogamelist.xmlisn't strictly valid XML (Onion's own gamelist generator writes such files) open again instead of showing "Catalog unavailable"; a console with a damaged cache row is repaired once instead of being rescanned on every entry (#238). - ๐๏ธ Tweaks โบ Appearance โบ Game list...: rows per page, text size, title scrolling speed and delay, case-sensitive sort and the dynamic favorite star, without editing files by hand (#238).
- โก ~270 KB launcher instead of ~1.4 MB, idle CPU in menus ~5% โ ~1% (Mini+), scrolling long titles ~35% โ ~6%, box art scaled in the background.
- ๐ฎ Letter jump, configurable row count, auto-scrolling titles, gamelist details, custom context menus, configurable main menu, safe ROM deletion on FAT32 with recovery after a power cut, new About device screen.
- ๐ Search with X opens Games โ Search with the results, as stock does.
- ๐ Brightness, Menu sound and Sleep timer click on every step, also at the lowest and highest value.
- ๐ Delete ROM, Clear Recents and Shutdown need a separate press of A to confirm, so a long press can no longer delete a ROM by accident.
- ๐จ Theme text with a font size of 0 is hidden, as in stock (DS XS, Game Boy Scouts and similar themes now look right).
- ๐ Many fixes for Favorites, Recents and Favorites folders, including games listed twice and recovery from damaged files.
- ๐ถ Wi-Fi networks with spaces or special characters in the name or password.
- ๐ ROM caches, Recents and Favorites are used as they are, and stay compatible with the stock MainUI.
โฉ๏ธ Going back to the stock MainUI
The stock MainUI is kept on the card. To switch back without reinstalling, create an empty file named DISABLED in .tmp_update/mainui-test/ on the SD card and restart. Delete it to switch back to Open MainUI. If the Open MainUI binary is missing, the stock MainUI starts on its own. If you tested Open MainUI before and created a DISABLED file, delete it to use Open MainUI.
๐ง Fixes
- Flip, lid close (#228): with Lid close action = Suspend and Power single press = Shutdown, closing the lid powered the device off. The lid now follows only its own setting.
- GameSwitcher (#233): removing the running game and starting the one that takes its place went back to the main menu instead of launching it. A long-standing bug, also present in official Onion.
- RetroArch menu on vertical games (#235): the RetroArch menu was drawn with the game's rotation. It now always displays upright, and the game returns to its rotation when the menu closes. RetroArch is updated to
1.22.2-2.
All three confirmed fixed on the Mini v4, Mini+ and Mini Flip.
Since the first beta:
- Mini v4 resolution: a boot-time shortcut could keep the Mini v4 at 640x480 for the whole session. It now waits for the display driver, as official Onion does.
- OTA updates: the updater no longer runs a file system repair on the SD card while it is in use, which could damage files. If you see
FSCK0000.REC-style files in the root of your card, check the card on a PC.
๐งช CI
- Every combination of lid close action and Power single press is now covered by tests, including the #228 case.
- The release workflow can publish a build as a pre-release, so it reaches only the beta OTA channel until it is promoted.
๐ก Tips
- Scrolling titles: long titles scroll after one second. Change the speed and delay, or turn it off, in Tweaks โบ Appearance โบ Game list....
- GameSwitcher shows the box art: the GameSwitcher saves a screenshot of a game the first time you open it while that game is running. Until then, opening it from the menu shows the game's box art, which for some systems is portrait.
- RetroArch settings that don't stick (#224): RetroArch doesn't save settings on exit, and cores like gpSP ship a core override with Keep Aspect Ratio on. Use Quick Menu > Overrides > Save Core Overrides to change it for good.
- RetroArch global settings (such as the language): change them from the RetroArch app in Apps, not while a game is running. During a game RetroArch uses a combined configuration that Onion restores on exit.
- Switching from another build (#231): format the card, or replace the
Appfolder too, then bring back only Roms, Saves, BIOS and Screenshots. Leftover app files from other builds can stop apps from starting.
โ ๏ธ Known limitations
- Some new Open MainUI labels are English-only for now.
- GLO (Game List Options): press Y, then A. Open MainUI doesn't open it with Y alone yet (robcodedev/onionos-mainui-opensource#14).
- Theme overrides from Tweaks (for example the battery percentage size) are not applied by Open MainUI yet (robcodedev/onionos-mainui-opensource#15).
- Menu long press set to Context menu (the default) does nothing in Open MainUI yet: open the context menu with Select (robcodedev/onionos-mainui-opensource#17).
- Open MainUI 1.0.4 is tested on the Mini Plus, Mini v4 and Mini Flip. On the Mini v4 and Mini Flip, switching between MainUI and a game's own resolution relies on Onion 4.5-dev fixes not yet merged in official Onion; OnionPlus already includes them.
๐งช If you'd like to try it
Switch the OTA updater to the beta channel to receive this build. Useful things to check:
- Browsing, launching games and returning to Open MainUI
- Search with X, Recents, Favorites and the GameSwitcher
- Brightness, Menu sound and Sleep timer in Settings
- Switching to the stock MainUI with the
DISABLEDfile, and back - A vertical game: open and close the RetroArch menu
- On the Flip: closing and opening the lid with different settings
Please report OnionPlus issues on the OnionPlus tracker, with your model, the version (from .tmp_update/onionVersion/version.txt) and the steps to reproduce. If a bug turns out to be in official Onion too, I'll pass it on with the fix.
๐ Thanks
Thanks first to the Onion team and to the community. OnionPlus sits on their work: the OS and the years of fixes already in the tree. None of this exists without that.
Thanks to @robcodedev for Open MainUI, and to the testers who sent new reports and helped me confirm the fixes, especially @Zazzago, @Ziko577 and Veuks.
๐ฐ Bounty
The $20 bounty is still open through 31 October 2026. It goes to whoever reports the most verified bugs and improvements in that window.
Verified reports so far (OnionPlus and Open MainUI, bugs and improvements):
- Zazzago: 4 (#228, #233, #235, #238)
- Veuks: 4 (robcodedev/onionos-mainui-opensource#14, robcodedev/onionos-mainui-opensource#15, robcodedev/onionos-mainui-opensource#16, robcodedev/onionos-mainui-opensource#17)
๐ Links
- Repo: https://github.com/Amiga500/Onion
- Issues: https://github.com/Amiga500/Onion/issues
- Expected behaviour is still the official guide: https://onionui.github.io/docs
โ ๏ธ Back up your SD card before updating. At least copy
Roms,Saves,BIOSandScreenshotsto your PC. This release replaces the main launcher, and a backup is the quickest way back if anything goes wrong.
Full Changelog: OnionPlus-v4.4.0-beta-20261005-c94f3c45...OnionPlus-v4.4.0-beta-20261005-de9f0a80