Onion (and Eggs)

A performant and straightforward multi language retro gaming museum in your pocket.

Download newest release here

This release was made possible by Totofaki, Eggs, JimGray, Pixelshift, Shauninman and many more from the Onion community.

Installation
Features
Shortcuts

Check our wiki for additional documentation!

Installation

Firmware 20220419 is needed for Onion v3.10 and above.
(You can check your current version in Settings - Device info - Version)
If you can't or don't want to update, there are other solutions like older Onion versions and MiniUI.
We can't take responsibility if your device is bricked in the process.
Update instructions : Here

Installation (Fresh Install):

Format your SD card as FAT32. (Use a fast, trusted brand. The SD card sent with your Miyoo Mini is slow, and will likely ruin your experience and data.)
Unzip the .tmp_update folder and its contents to the root of your SD.
If using a Mac : This OS will add .-* files everywhere in your SD, you need to remove them before continue.
Boot up your Miyoo Mini and follow the on-screen instructions to get started.
Your Mini will turn off once installation is complete. (Don't delete the .tmp_update folder, it is now part of the Onion installation.)
Copy your Bios files into the BIOS folder.
Go to the console page, and refresh your rom lists by pressing the menu button.

Installation from any Onion version:

(If coming from <= V3.9, backup your saves (retroarch / .retroarch / saves | states), you will have to copy them afterwards in the Saves folder of your SD)
Delete all folders from your SD except BIOS, Roms, Saves and Themes (Save your ports if you used some in Emu\PORTS)
Note : Save your Saves folder to copy it back if you want to keep your custom emulator settings.
Unzip the .tmp_update folder to the root of your SD.
Boot up your Miyoo Mini and follow the on-screen instructions to get started.
Your Mini will turn off once installation is complete. (Don't delete the .tmp_update folder, it is now part of the Onion installation.)

Features

Theme Switcher App and Custom Themes

Preview and change themes on the fly, no reboot required.
Check themes from our community

Onion Installer

Install/uninstall only the systems and apps you need. All actions are reversible.
Community presets, homebrews and more.

Play Activity

Track your game play times.

Onion Launcher

Although it's optional, we consider the launcher to be central to the Onion OS experience.
The Onion Launcher is a user interface designed to be triggered when the Miyoo Mini starts.
It allows you to launch the last game played in a few seconds, and, with a simple press of a button, save your progress and turn off the console.
It also allows you to quickly change games and many other features:

Quick boot your last game played.
Quickly switch games from your history.
Full overlay with accurate brightness, battery readings and playtimes.
Improved Sleep Mode with full game suspension (menu + power).
Custom charging screen that prevents screen burn-in.
Removed low bat flickering icon.
Large new low battery (<10%) indicator with periodic warning rumble.
When the battery goes below 4%, the game is automatically saved to prevent losing progress, and the handheld is turned off.

RetroArch Rebuilt From Scratch

Rotation support for arcade games.
Custom video filters. You can now modify, or create your own.

Some examples made for this RetroArch port :
Normal_3X

LCD filters, click to magnify : (Integer + scaling)

Compiled and partially rebuilt by Eggs (Discord user no 968407509364772924) for precision and performance. Custom audio driver. Custom scalers. New display driver. New input driver.
Minimal input and audio lag.
Customs cores.
Fine-tuned with optimal best settings for the Miyoo Mini in mind.
Crisp 640*480 resolution.
Also a game launcher (cores embedded, playlists and favorites unlocked).

Guest mode

Guest mode is a separate profile so you can safely lend your device to your kid or your friend.

This profile include another space where can be saved : Saves States Video filter and scaling options. Core options Custom button remapping layouts. RetroArch history (The Onion Launcher list will be different to reflect this.) RetroArch playlists and favorites. Timers for your games (Play activity app) RGUI config (RetroArch Graphic User Interface)

Your personal files are now gathered in one place.

Your saves and most of your preferences are now in SDCARD / Saves. (Example: D:/Saves/) This also includes your secondary profile, your config files, RetroArch lists and play activity database. Simply copy this folder when you want to backup your data.

Miyoo audio server adoption

The "pop" sound that appears each time a binary is launched is now gone.

The audio sever lag has been removed. (Credit: Eggs)

Main UI improvments

Battery percentage is now visible on the main menu.

You can configure the battery percentage visibility and color in the theme configuration file. It is also possible to make a theme that only shows the percentage text.

No more audio lag (Credit: Eggs) New default theme inspired by the Lilla theme by Evolve. (Credit: DiMo) Onionos icon by Evolve. Textures are compression for faster results (Credit: DiMo) Box art size fix on the included themes (Credit: DiMo) For more information check the FAQ

Others

Many additional systems supported.
Experimental Arduboy support (credit: JMARoeder).
Updated PICO emulator to Fake08 standalone (credit: Supergrom).
Updated screenshot tool to v4 (credit: eggs).
Support for Icon Packs. Drag and drop custom icons into the "Icons" folder at the root of your SD.
Boxart moved to /Roms/systemname/Imgs for easier scraping.
Various bug fixes and optimizations.

Shortcuts

Menu button: Exit Game

Select + R2: Brightness up
Select + L2: Brightness down

Power button: Save progress and shutdown
Menu + Power: Light sleep

Menu + R2: Save state
Menu + L2: Load state

Menu + R: Fast forward
Menu + L: Rewind (if enabled)

Menu + X: Toggle FPS display

R2/L2: Change palette (Game Boy only)

Start + Select + R2 + L2: Force turn off
Menu + Select : Retroarch menu.

Start + Select + Menu + R2 + L2: Force disable the launcher

walmyrcarvalho / Onion