A ROM downloader and ROM manager for the Miyoo Mini and Miyoo Mini Plus, running on OnionOS.
RomManager is an on-device ROM downloader for the Miyoo Mini: browse your own game sources - archive.org items, web folders, or an FTP server on your PC - download your games over Wi-Fi with their box art, and play them, all on the handheld. No PC, no taking the SD card out.
It's also proof that a handheld app can feel smooth and polished on a small chip if it's built right. Everything animates, and when nothing moves the app uses no CPU at all, so the battery lasts and the device stays cool.
⚖️ RomManager doesn't include, host or link to any games. It only downloads from sources you add yourself. Only download games you own, and follow the copyright laws where you live.
- Home screen of six big tiles (or a plain list, if you prefer), with live counts - and live progress while something downloads.
- Boot screen with a loading bar that follows the real start-up, your library at a glance, and a tip.
- Slides, fades and pop-ups between screens; notices slide in and go away by themselves, so nothing makes you wait.
- Cover flow in every game and console list (press R): covers slide past with reflections, and the selected one floats gently.
- Its own icons for consoles and menus, so RomManager looks the same whatever Onion theme you use.
- Animations can be turned off in Settings.
- A screen engine written in C for the Mini: double buffering (no tearing), NEON-accelerated drawing, and box art decoded on the second CPU core so scrolling never waits for it.
- No CPU used when idle - the screen only redraws when something changes.
- Separate small programs for the buttons (no missed or laggy presses) and the sound (music and button sounds mixed, so the music never pauses).
- Crash-safe: problems are logged to
caches/rommanager.logand RomManager restarts itself.
- Add archive.org items, web folders or FTP folders, and see every game they have for a console in one merged list, without duplicates.
- Multi-console packs: add a whole collection at once; RomManager matches its folders (or per-console zips) to consoles and marks any the Mini can't run.
- Help while typing: start an archive.org ID and a matching item is suggested.
- archive.org login for items that need an account - only the login cookie is kept, never your password.
- Background downloads: pick a game and keep browsing. Queue as many as you like; X on the home screen opens the queue with speed, time left, retry and cancel.
- Resume: downloads stopped by a game or a power-off carry on where they left off.
- Before you download: the game's size and your free space, and a check mark on games you already have.
- Sort & Filter (Y): A-Z or biggest first, one region, hide betas / demos / hacks, hide games you have.
- Box art with every game, and disc games get their
.cuetoo. Preview covers for games you haven't downloaded are fetched three at a time, nearest first, and stored small.
- A plays any installed game, favorite or recent download. If its emulator is switched off in Onion, RomManager offers to turn it on.
- Default Launcher: a game started from RomManager comes back to it when it ends - straight to the screen you left, no boot screen. Menu opens Onion's game switcher, and B there comes back too. Games you start show up in Onion's game switcher and Recents. Close RomManager and Onion is back to normal.
- Search with the on-screen keyboard, L2 / R2 to jump by letter, and every list remembers where you were.
- Favorites across all consoles, and a Recent Downloads list.
- Get box art for one game or every game missing it; delete a game together with its disc files and art.
 Boot screen |
 Consoles in cover flow, with RomManager's own icons |
 A source's games - check marks on the ones you have |
 Size and free space before you download |
 The download queue, running in the background |
 Every setting explained on the status line |
The games shown are homebrew, with box art from the Libretro thumbnails project; game counts and sources are sample data.
- Download the latest
RomManagerzip from the Releases page. - Copy the
RomManagerfolder inside it to/App/on your SD card, so you have/App/RomManager/launch.sh. - Put the card back in, turn on Wi-Fi, and open RomManager from Onion's Apps.
Updating from 1.x: copy the new RomManager folder over the old one - your repos, favorites and settings are kept.
Devices: Miyoo Mini and Mini Plus on OnionOS. The screen adapts to the Mini v4 / Flip resolution, but those haven't been tested yet - reports are welcome.
| Source | What you type | Example |
|---|---|---|
| archive.org item | The ID after archive.org/details/ |
homebrew-console-pack |
| Web folder | An http(s):// address that shows a file list |
https://myserver.local/roms/psx/ |
| FTP folder | An ftp:// address, with a login if needed |
ftp://user:password@192.168.1.20/roms/ |
Open Repositories > + Add a repository, type the address (L shows symbols such as : / . @), and pick a console or Multi-console pack. A pop-up shows what was found: Save, Edit or Cancel.
Sources live in RomManager/repos.txt, so you can also set them up on a PC:
# CONSOLE | SOURCE | FORMAT (optional extra file types)
MD | homebrew-console-pack
PS | ftp://user:password@192.168.1.20/psx/ | chd
* | https://myserver.local/roms/
CONSOLE is Onion's ROM folder name (PS, MD, MS, PCE, NEOGEO...), or * for a pack.
| Button | Game lists | Keyboard |
|---|---|---|
| D-Pad | Move (list: left / right jump a page; cover flow: up / down jump) | Move |
| L2 / R2 | Previous / next letter | - |
| A | Download / Play | Type |
| B | Back | Delete a letter |
| X | Download lists: re-read the sources. Installed: get the box art | Done |
| Y | Download lists: sort & filter. Installed: delete the game | - |
| Start | Add / remove favorite | Done, or accept the suggestion |
| Select | Search | Cancel |
| R | List / cover flow | Capitals |
| L | - | Space (search) / symbols (addresses) |
| Menu | Onion's game switcher | Onion's game switcher |
Home screen: X opens the download queue; B twice exits. Repositories: A add or edit, Y remove, X file format, Select move to another console, Start review a pack.
| Setting | What it does |
|---|---|
| Music Volume / Sound Effects | Volume bars from off to full |
| Home Screen | Big tiles or a plain list |
| Animations | On or off |
| Open To | What RomManager opens on from Onion: Main Menu, Installed ROMs, or where you left off. Back from a game, it always returns where you were. |
| Default Launcher | Games started here, and B in Onion's game switcher, come back to RomManager while it's open |
| List Rows | How many rows a list shows |
| Auto Scrape Covers | Download box art with every game |
| Repo Cache | How many days source lists are kept before being read again |
| Tools | Scrape Missing Box Art, Prefetch Repo Previews, Manage Preview Cache, Clear Repo Cache, Rebuild Local Database |
| Credits & About | Who made RomManager |
settings.ini only: PREVIEW_CACHE_MB (space for preview covers, default 40), AUDIO_OUT (auto or dsp, if sound doesn't work on your setup), SHOW_PERF=1 (frames per second and CPU use on screen).
RomManager is a shell script plus three small C programs in src/: rmui (the screen engine), rmkey (buttons) and rmaudio (the sound mixer).
sh src/rmui/build.shbuilds them for the Mini with a Linaro GCC 8.2 ARM toolchain intools/miyoo-toolchain.sh src/rmui/build.sh previewbuilds a PC version that draws screens to PNG files, for working without the device.
RomManager is made by plusCloud - designed, built, tested and debugged as an ADHD special interest after realizing nothing like it existed: the app, the screen, button and sound engines, sources, downloads and the look.
Contributions by brenonsc: automatic file-format detection, bulk cover prefetching, choosing which consoles' cached previews to delete, .cue downloads for disc games, case-insensitive archive.org IDs, and reliability fixes.
Icons by Bernig.
Also: box art from the Libretro thumbnails project; stb_image / stb_truetype by Sean Barrett; minimp3; and the OnionOS team.
RomManager doesn't include, host or link to any games - it downloads only from the sources you add. Only download games you own, and follow the copyright laws where you live. RomManager isn't affiliated with any console maker or with OnionOS.