sdOS
Install, copy games, update, and fix a wrong screen.
The public image is still coming soon. These steps are for when you have it, and for anyone already running 0.1.2 or later.
Install
Use a good microSD card. 24 GB or larger is recommended, so first boot can create the Windows-readable GAMES partition. Flashing erases the card.
When the public download is posted, it will be a compressed disk image, named like sdOS-0.1.x-h700.img.gz. Don’t unzip it.
On Windows, open Rufus, choose the microSD card, choose the .img.gz file, and write. Raspberry Pi Imager (Choose OS → Use custom) and balenaEtcher also work, and also read the compressed file directly. Skip any OS customization in Raspberry Pi Imager.
Put the card in the slot marked TF1 and power on. The first boot takes one to two minutes while the card is set up. You’ll see the sdOS mark, then Setup.
Pick a language (English is available now; other languages are listed as Later), join Wi-Fi or skip it, and set your time zone. On a 24 GB or larger card, first boot creates the GAMES partition. Home only shows systems that have games.
Games
Power the handheld off, take the card out, and open it on a Windows (or Mac) computer. You should see a drive labeled GAMES. Copy each game into the matching folder inside roms — for example psp, psx, snes, gba. A text file on the card, sdOS - which folder.txt, lists every folder.
Popular folders are listed first on the handheld’s copy screen: PSP, PlayStation, Super Nintendo, Game Boy Advance, Nintendo 64, Genesis, NES, arcade, FinalBurn Neo, Game Boy, Game Boy Color, Nintendo DS and Dreamcast, then every other folder.
PSP games (.iso / .cso) go in psp and need no BIOS. Some other systems need BIOS files that you supply yourself in bios. None are included.
Cards smaller than 24 GB don’t get a GAMES partition. In that case, copy over the network share, or use a second card if Setup offered one.
Saves
From 0.1.4, every save is on the GAMES drive under roms\saves. Back up that whole folder if you care about your progress.
saves\<system>, with states in saves\states\<system>.saves\psp\SAVEDATA and saves\psp\PPSSPP_STATE. In Windows, a typical path looks like GAMES:\roms\saves\psp\SAVEDATA\<GAMEID>.A saves\README.txt file on the card explains this. If you roll the app layer back from 0.1.4 to 0.1.3, the saves stay on GAMES, and PPSSPP won’t see them until 0.1.4 is installed again.
Updates
On the handheld, open Settings → Update, with Wi-Fi connected. sdOS downloads the latest interface, checks it, and runs it on trial. If the new layer fails to start twice, it goes back to the previous one.
0.1.2 and 0.1.3 can update to 0.1.4 this way. 0.1.1 cannot — it needs a reflash to 0.1.2 or later, and then Update will work. Changes to the base system still need a new image.
Wrong screen
Go to Settings → Device model and pick your handheld by its retail name. If the picture is still off, choose Screen looks wrong? Try alternate screen.
sdOS restarts on a trial. You’ll be asked “Does the screen look right?” You have 30 seconds to confirm. The cursor starts on Go back, so if you can’t see the menu, pressing A takes you back. If you don’t confirm in time, it reverts on its own and restarts.
If the interface never comes up, power off, put the card in a Windows computer, and open the drive labeled SDOS (the boot partition). Run SET-DEVICE.bat, pick your model — alternate screens are listed separately — and put the card back. The script copies the matching screen and buttons file into place.
FAQ
RG35XX H, RG35XX Plus, RG35XX 2024, RG35XX Pro, RG35XX SP, RG34XX, RG34XX SP, RG40XX H, RG40XX V, RG CubeXX and RG28XX. The first target was the RG35XX H.
The RG SP uses a separate download, which is coming soon. The original RG35XX is not supported.
No. Write the .img.gz file directly in Rufus, Raspberry Pi Imager or balenaEtcher.
The slot marked TF1. First boot takes one to two minutes.
24 GB or larger is recommended, so first boot can create the exFAT GAMES partition that a computer can open. Smaller cards still work, but that Windows-readable games area is not created; use the network share to copy games.
No. You supply games, and any BIOS files a system needs, yourself. PSP games need no BIOS.
Username sdos, password sdos, at \\sdos\games. Guest sign-in is off.
No. 0.1.1 needs a new image. 0.1.2 and 0.1.3 can install 0.1.4 from Settings → Update.
That’s expected until official PICO-8 is in roms/pico-8 (or roms/pico-8/aarch64). Then Splore appears on Home.
Yes. It is a free, open-source system. Licenses are listed on the handheld under Settings → About & licenses.