FAQs - Olywa/Onion GitHub Wiki

The file format is PNG with a max size of 250x360. The images need to be placed into the /ROMS/<gamesystem>/Imgs folder.

The Imgs folder name is case sensitive (must have a capital 'I'). Examples would be like the following:
/Roms/FC/Imgs
/Roms/SFC/Imgs
/Roms/GB/Imgs

You can scrape your box art or screenshots automatically by following the below process:

• Use https://www.skraper.net/
• Log in & select "Recalbox"
• Check "Include non-Recalbox rom folders"

  (Some systems aren't recognized because their folder-names are non-standard. To add those systems, press the + symbol on the bottom left, select the systems that are missing & hit "OK". Then click the added systems in the bar on the left, and correct the system's folders in the "Games/Roms folder" bar or by clicking the file-icon to the right of it. You can find a list of all Rom folder names here

• Go to the "media" tab -> Enable & set "Resize width to" to 250 and enable "Keep Image Ratio"
• Select the image type you don't want in the "Fetched Media List" and press the "minus" button, so there's only one picture.

  You can change how the image mix looks with the two buttons under "Media type", I recommend changing "4 IMAGES MIX" to "Screenscraper's Recalbox Mix V2", but use whatever you prefer. If you choose a picture that's taller than it's wide, like the boxart, set "Resize height to" to 360 and disable "Keep Image Ratio"

• Change "Output folder" to %ROMROOTFOLDER%\Imgs, with a big I.
• Under 'Gamelist Link' ensure that 'Link from node ' is ticked as well as 'Optimize media storage' (these are important if you wish to use the generated gamelist.xml to create a miyoogamelist.xml for use in Onion (more info on this below on this page).
• Now click the system you want to scrape for on the left side, or "all system", and press the play button in the bottom right corner.

This will automatically scrape images to the correct folders for Miyoo Mini.
(Credit: Julian)

Onion uses a 'miyoogamelist.xml' (in the same format as the more common 'gamelist.xml'). To create a miyoogamelist, review the guide here.

Troubleshooting: After adding the miyoogamelist.xml to your rom folder you will need to refresh your roms (as above) to parse it. If the list is still not being used, ensure that the extlist in the Emu//config.json is populated with the appropriate rom extensions for your games (i.e. "extlist":"zip|ZIP")

Important: The guide includes a 'clean up' script for use with xmlstarlet but an issue with viewing PDF files in a browser means the script does not copy well. Either open the PDF in a reader application (i.e. Adobe Acrobat) or use this batch file to run the script

From the ‘Consoles’ menu, highlight the system and press the SELECT button to evoke the 'Refresh All Roms' option and press A.

Any time you add more roms you will need to refresh your roms. From the ‘Consoles’ menu, highlight the system and press the SELECT button to evoke the 'Refresh All Roms' option and press A. If your newly added games are still not appearing, ensure that you have placed your roms in the correct rom folders. Rom folders for each system must be named in capitals and they will differ from those on the stock Miyoo Mini SD Card.

If you experience slower (or faster) gameplay than usual for some games following an Onion upgrade, we recommend that you create an in-game Save and then delete your Save States. Save States are stored inside Saves/CurrentProfile/states/[CORENAME]/

Please see other solutions here within this FAQ with regards to managing Save States and Saves.

If you launched a rom or a file that is incompatible with the core, it can lead to a black screen. Onions auto-resume feature can lead to you returning to this same black screen on each boot.

You can hold down POWER for 10+ seconds to break you out of this behaviour and return you to MainUI

If this still does not work for you, you can disable the next auto-resume by inserting your SD card into your PC and delete the file cmd_to_run.sh inside the /.tmp_update folder

You can copy game save files from another device or emulator for use in OnionOS.

• Save files should be in .srm format, named identically to the rom and are case sensitive. Note that .sav files can be renamed to .srm, other formats may require a conversion tool.
• To add your saves to OnionOS just copy your individual save files into the correct emulator folder in: Saves/CurrentProfile/saves/[CORENAME]
• If you have already launched the game prior to adding your saves then you will also need to go to the Saves/CurrentProfile/states/[CORENAME] folder ...and delete any Save States here for the same game(s) in order for your newly added game saves to be recognised.

[CORENAME] = the folder with name of the core for the particular emulator or system 'core', the save file(s) relates to

Save States are stored inside Saves/CurrentProfile/states/[CORENAME]/

Notes: [CORENAME] = the folder with name of the core for the particular emulator or system 'core', the save state file(s) relates to

To do this, launch the game and press MENU + SELECT to go into the RetroArch menu.

Then press B to go back one level. Go to Setting > Saving > Load State Automatically (and turn it off). Press B twice and go to Quick Menu > Overrides and save either Game Overrides (for only that one game), Core Overrides (for all games played by this core) or Content Overrides (for all roms in the same folder as this game).

Onion enables a feature that retains your old save states.
So in case of manipulation error, file corruption or simply because you want to go earlier in the game than you thought, it is possible to go back in time to select another save state.
It will not take much space in your SD. Even if your save slot number is high, RetroArch will never save more than 20 files.

(Credit: Erazemk)

This guide will teach you how to add cheats for your RetroArch emulators.

Your first task is to find cheat files for your games (usually provided in .cht format). You can find them fairly easily online, but the recommended source is LibRetro database, which has up-to-date cheats for most LibRetro supported emulators.

1. Download the whole repository as a ZIP file (Code -> Download ZIP),
2. Extract it and go into the cht directory (you will see cheats sorted by console),
3. Copy directories for consoles you want to your Miyoo Mini's SD card, into the RetroArch/.retroarch/cheats directory (you might have to enable showing hidden directories if you can't see the .retroarch directory),
4. Inside the .retroarch directory there will be a retroarch.cfg file, which you need to open in a text editor. Find the line with the option quick_menu_show_cheats and set it to "true" (so the whole line should be quick_menu_show_cheats = "true"),
5. Eject your SD card from your computer and plug it into the Miyoo Mini, then open up your favourite game (for which you have downloaded cheats),
6. Enter the RetroArch menu (press Menu, hold it, then press Select) and find the Cheats -> Load Cheat File (Replace) option. There you can find the cheat file in one of the directories. After choosing it you will be returned back to the cheats menu, but now you should see a number of cheats at the bottom (e.g. Cheat #0),
7. Select one of them, then toggle the Enabled switch to enable it.

When you make changes in retroarch you must apply these using ‘Overrides’ for them to take effect.

To do this, launch the game and press MENU + SELECT to go into the RetroArch menu.

Then, after making your changes, go to Quick Menu > Overrides and save either Game Overrides (for only that one game), Core Overrides (for all games played by this core) or Content Overrides (for all roms in the same folder as this game).

Notes: Content Overrides are recommended over Core Overrides since some cores serve multiple systems. For more information regarding RetroArch inputs and controls please review the libretro documentation here.

To do this, launch the game and press MENU + SELECT to go into the RetroArch menu.

Choose Quick Menu > Controls > Port 1 Controls, make the control changes you desire and then press B to go back one level, and then go to Manage Remap Files > Save Game Remap File (for just this game) or Save Core Remap File (for everything the core plays) or Save Content Remap File (for everything in the same Rom folder).

Notes: Content Overrides are recommended over Core Overrides since some cores serve multiple systems. For more information regarding core overrides please review the libretro documentation here.

(Credit: Dwmccoy)

My solution for multi-disc games was to store the Roms in a different folder.

Example: Driver 2

Copy the bin/cue files for the multi-disc game Driver 2 into the following folder of /Roms/PSX/Driver 2

I had two disc files to copy into the /Roms/PSX/Driver 2 folder Driver 2 (Disc 1) (v1.1) and Driver 2 (Disc 2) (v1.1) I then created an m3u file named Driver 2 (v1.1).m3u with the following content and placed it into the /Roms/PS folder

../../Roms/PSX/Driver 2/Driver 2 (Disc 1) (v1.1).cue
../../Roms/PSX/Driver 2/Driver 2 (Disc 2) (v1.1).cue

Launch the PlayStation Emulator and the only file you should see for the "Driver 2" game is the m3u file since the disc(s) for the game reside in a different folder.

You can store the files in whatever folder you want as long as the path to the cue file is correct. I created the folder PSX to store the multi-disc images in for simplicity. It's a bit of a hassle but it does work.

The name of each console or system is defined in /Emu/<systemname>/config.json You can edit this file with a text editor on your PC and apply a new name by updating the 'label' field.

To easily make bulk changes to your console or system names you can use the excellent python scripts below by Andrea922. Visit the onionos-console-renamer github to download and follow the instructions detailed there.

(Credit: JitteryCore)

• Open RetroArch via App ➜ RetroArch
• Go to Settings ➜ User Interface ➜ Menu Item Visibility ➜ Settings
• Toggle on Show 'Frame Throttle'
• Go back to RetroArch settings (press B three times)
• Choose the (now available) Frame Throttle setting
• Adjust the Fast-Forward Rate to your needs
• Remember to save the configuration:
  • Go back to RetroArch main menu
  • Go to Configuration File and choose Save Current Configuration

It is likely due to a lack of compatibility with the Miyoo audio server. To cope with this, just rename the launch.sh file in your app folder to launch2.sh, then extract this file to the app folder: launch.zip