Skip to content

Open MainUI 1.0

Choose a tag to compare

View all tags
@robcodedev robcodedev released this 26 Sep 22:13
· 139 commits to main since this release
v1.0
9018d27

First public release of Open MainUI, an open-source replacement for MainUI, the main launcher screen of Onion on the Miyoo Mini, Mini Plus and Mini Flip. It builds on the features of the patched MainUI project, rewritten from scratch as readable, fixable C.

It is usable day to day, but it is a 1.0: keep a backup of your SD card before installing.

Highlights

  • Browsing, Recents, Favorites with folders, search, Apps, game launch and return, themes and the stock settings screens.
  • Much faster ROM cache rebuilds: a 5,000-ROM folder with 16,000 images rebuilds in under a second (stock: over 5 minutes).
  • Faster list navigation, lower CPU use, and a device binary of about 200 KB (stock: 1.4 MB).
  • Letter jump, configurable row count, auto-scrolling titles, gamelist.xml details, custom context menus and a configurable main menu (main-menu.json).
  • Safe ROM deletion on FAT32, with automatic recovery after a power cut.

See CHANGELOG.md for the full list and known limitations.

Requirements

  • Onion OS (tested on: V4.4.0-beta-20260120). Works with the existing ROM caches, Recents and Favorites; your files stay compatible with stock MainUI.
  • Tested most on the Mini Plus. Reports from Mini and Mini Flip owners are especially welcome.

Install

Download MainUI below. It is the file called build/onion/MainUI in the install guide.

  • Simple: with the device off, back up your original launcher files in .tmp_update/bin/ (MainUI-283-*, MainUI-354-*, MainUI-285-*), then copy MainUI over each of them, keeping their names.
  • With a stock switch and logging: use MainUI-test-wrapper.sh as described in the guide.

Full steps, including how to return to stock: docs/BUILDING.md - Installing on a device.

If something goes wrong: docs/TROUBLESHOOTING.md.

Files

  • MainUI - device binary (ARM, for Onion)
  • MainUI-test-wrapper.sh - optional wrapper for the stock switch and logging
  • SHA256SUMS - checksums

Notes

Unofficial and not affiliated with Miyoo or the OnionUI team. Much of the code was written with the help of AI; not all of it has been reviewed by humans. Licensed GPL-3.0-only, like Onion.

Assets 5
Loading