plus-cloud/rommanager

RomManager is an application for the Miyoo Mini and Miyoo Mini Plus, two small handheld gaming devices that run emulators for classic consoles. Specifically, it is built for OnionOS, a custom operating system installed on those handhelds. The app runs entirely on the device itself, letting you browse and download game files over Wi-Fi without ever needing to remove the SD card or plug into a computer. The main thing it does is connect to public internet archives, where people share collections of older game files, and present those as scrollable lists directly on the handheld screen. You navigate with the D-pad, find a game, and download it straight to the right folder on your SD card. When a download finishes, the app also fetches cover art automatically from a thumbnail database, so your library gets box art without any extra steps. The interface is built in shell script and uses the device's screen buffer directly rather than any heavy framework. The README emphasizes this was a deliberate choice to keep menu scrolling fast on the low-power chip inside the Miyoo. Game title names from archive databases often include messy shorthand codes for regions and revisions, so the app cleans those up on the fly so they match correctly against the art database. For local library management you can browse what is already on your SD card, scrape missing artwork for individual games, or delete files you no longer want. There is also a favorites list that works across different console folders, and background music with sound effects that resume from where they left off when interrupted. Installation is a drag-and-drop: download the zip from GitHub, pull out the folder inside it, and copy it into the App directory on the Miyoo's SD card. The app launches from the OnionOS apps screen. The README notes it does not host or bundle any game files itself.