Installation - schmurtzm/test GitHub Wiki
![]() |
CrossMix-OS doesn't require any firmware update before installation: it will guide you to update it if required, just let yourself be guided on the first boot. CrossMix-OS use the firmware 1.0.4 hotfix 6 (20240413) by default (no need to update it before your CrossMix installation), hotfix 9 is also supported but boot logo change is disabled. |
Format your SD card in FAT32. (⚠ use a genuine, name-brand SD card and not the stock one sold with your console)
Prepare your SD card to receive CrossMix-OS:
- Use fat32format
- Set options
- Drive
The drive letter of your SD card - Allocation unit size
Card capacity Allocation unit size < 128 GB 512 < 256 GB 1024 < 512 GB 2048 < 1 TB 4096 < 2 TB 8192 - Volume label
CrossMix
- Quick Format:
✔️ Yes
- Drive
- Press Start and wait for the process to finish.
It can take a couple of minutes depending on the size and speed of the card and the reader.
- Plug in the SD card in the reader, then plug in the reader to your Mac.
- Choose "Application" > "Utilities" > "Disk Utilities"
- From the sidebar, click on the USB drive you want to format to FAT32.
- Choose "Erase" from the toolbar
- In the "Format" drop-down menu, select the option "MS-DOS (FAT)".
- In the "Scheme" drop-down menu (if it exists), select the option "Master Boot Record".
- Click "Erase" and wait for the process to finish.
It can take a couple of minutes depending on the size and speed of the card and the reader.
- Download the latest release of CrossMix-OS (in the "assets", at the bottom of the release page, look for
CrossMix-OS_v1.x.x.zip
) - Extract the archive to the root of your formatted SD card.
- Copy your BIOS files into the
BIOS
folder (on stock SD card copy it fromRetroArch/.retroarch/system
toBIOS
folder) - Copy your own ROMs into the
Roms
folder. If you want to keep roms from stock SD card, copy the content of eachRoms
subfolder from stock SD card one by one, some rom paths are different from Stock so if you don't find the target folder or if you have any doubts, find the right path in CrossMix emulator list. (Some examples of rom path changes : PPSSPP -> PSP , OPERA -> PANASONIC , PICO8 -> PICO) - Insert your SD card into your TrimUI Smart Pro and start CrossMix-OS. (the first boot is a little longer than usual to setup some components like PortMaster)
- Run a check disk on your SD card first (as there are many bad SD cards, it's always a good idea to check for errors with chkdsk on Windows, fsck on linux or Disk Utility on Mac) (use a genuine, name-brand SD card and not the stock one sold with your console)
- Copy the archive "CrossMix-OS_v1.x.x.zip" (⚠ archive not extracted ⚠) on SD card root
- ⚠ Update the file
_FirmwareCheck.sh
located inSystem/starts
with the new version from the archive "CrossMix-OS_v1.x.x.zip" or from here⚠. - At reboot the update will be automatically installed
The decompression time is around 4 minutes with a good SD card (it can be longer depending the SD quality).
The following folders are not altered during the update:
- SDCARD/Data - SDCARD/BIOS - SDCARD/Best - SDCARD/Imgs - SDCARD/Roms
The automatic update process will move your previous files in
SDCARD/_Updates
folder. You'll also find the migration log in this directory.The saves/savestates from Retroarch, PPSSPP, Drastic are automatically copied from the backup to the new installation.
After an update, it is recommended to keep this
_Updates
folder for some time. Once you have spent some time on CrossMix and verified that all your saves are functional, you can delete this_update
directory to free up storage space on your SD card.
You can't just override the files to have a good result. Do not use the stock SD card (otherwise you'll have corruption of filesystem very often and loosing files). This procedure is to migrate to CrossMix on a guenuine SD card which is already used for another OS. The process is similar with a separate/dedicated SD card except that you copy the stock files from the initial SD card instead of "_Mybackup" folder.
- Run a check disk on your SD card first (many SD card filesystem are already partially corrupted before installing so it's always a good idea to check for errors with scandisk or chkdsk on Windows, fsck on linux or Disk Utility on Mac)
- create a folder called "_Mybackup" for example and put all your existing files/folders in it. You now have only one folders on your SD card.
- extract the CrossMix archive on your SD card root.
- copy your BIOS files into the BIOS folder (on stock SD card copy it from
/_Mybackup/RetroArch/.retroarch/system to BIOS folder
to/BIOS
) - move Roms folders but don't import roms folders which are not coming from CrossMix ! Some name are different: PPSSPP -> PSP , OPERA -> PANASONIC , PICO8 -> PICO (so for example copy the content of
_Mybackup/Roms/PPSSPP/*
inRoms/PSP
, if you don't find the target folder or if you have any doubts, find the right path in CrossMix emulator list) - Insert your SD card into your TrimUI Smart Pro and boot the console.
- Refresh roms
About saves and save states:
- The save states made with the in game menu are contained in Roms folder, most of them should work directly except if the core is different: in this case the content folder will not have the same name.
- if you really need some save and save states from Retroarch the paths have changed for a more clean organization. It's probably easier to make a save with the in game menu before migrate to CrossMix, otherwise the migration is manual: the base folder is the same (
RetroArch\.retroarch\saves
andRetroArch\.retroarch\states
) but on CrossMix it isRetroArch\.> retroarch\saves\**RomFolderName**\**Corename**
.For example :
RetroArch\.retroarch\saves\001 Donkey Kong Land.srm
wil go into :RetroArch\.retroarch\saves\GB\Gambatte
Previous: Home | Back to top | Next up: Emulators |
---|