sdOS

sdOS

Support

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

Flash a microSD card on Windows.

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.

01 Get the image

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.

02 Write it with Rufus

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.

03 Boot

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.

04 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

Copy games from Windows.

From the GAMES drive

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.

From the network share

Join the handheld to Wi-Fi. On a Windows computer on the same network, open File Explorer and go to \\sdos\games. If the name doesn’t resolve, use \\ followed by the handheld’s IP address, then \games. The copy screen on the handheld shows the address when the share is on.

Sign in with username sdos and password sdos. Guest access is off, because Windows 11 blocks guest shares. Settings → Network share turns the share on or off.

Saves

Where saves live, and how to back them up.

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.

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

Update over the air.

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

If the picture looks wrong.

On the handheld

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.

From a computer: SET-DEVICE.bat

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

Common questions.

Which handhelds does this image support?

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.

What about the RG SP, or the original RG35XX?

The RG SP uses a separate download, which is coming soon. The original RG35XX is not supported.

Do I have to unzip the image?

No. Write the .img.gz file directly in Rufus, Raspberry Pi Imager or balenaEtcher.

Which card slot do I use?

The slot marked TF1. First boot takes one to two minutes.

How large a card do I need?

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.

Are BIOS files or games included?

No. You supply games, and any BIOS files a system needs, yourself. PSP games need no BIOS.

What is the share password?

Username sdos, password sdos, at \\sdos\games. Guest sign-in is off.

Can I update from 0.1.1 without reflashing?

No. 0.1.1 needs a new image. 0.1.2 and 0.1.3 can install 0.1.4 from Settings → Update.

PICO-8 Splore isn’t in the list.

That’s expected until official PICO-8 is in roms/pico-8 (or roms/pico-8/aarch64). Then Splore appears on Home.

Is sdOS free?

Yes. It is a free, open-source system. Licenses are listed on the handheld under Settings → About & licenses.