Skip to content

Installation ​

Installing Tetsu OS means writing an image to a microSD card and adding the TETSU-DATA partition, where your games and saves live. Nothing is installed on the device itself: take the card out, and the stock firmware starts as before.

Check your memory type first

v0.1 starts only on units with LPDDR3 memory; later builds also start on LPDDR4. See Check your memory type. To test a build on an LPDDR4 unit, see Testing your device.

1. Download an image ​

Open the project's Releases page and download the card image of the newest release. Skip any marked Pre-release: those are test builds, for testing your device.

FileWhat it is
tetsu-rg35xxsp-<version>-sdcard.img.gz, such as tetsu-rg35xxsp-v0.1-sdcard.img.gzThe card image for a new install
SHA256SUMS-rg35xxspChecksums, to check the download
tetsu-rg35xxsp-<build>.img.gz, manifest.txt, manifest.sigThe signed update that SYSTEM UPDATE downloads. You don't need these to install
tetsu-rg35xxsp-<version>-sources.tar.part*, -licences.csvThe sources of the GPL and other components, and their licences

Check that the download is complete: with SHA256SUMS-rg35xxsp in the same folder,

bash
sha256sum -c --ignore-missing SHA256SUMS-rg35xxsp

prints OK after the image's name.

2. Write the card ​

The image holds the boot partition and the system. TETSU-DATA comes after it, starting 4 GiB into the card, and fills the rest. The device adds it on its first start from the card, so any image writer will do. Because it lies past the image, writing a new image later leaves your games and saves where they are.

Option A: an image writer ​

Write the .img.gz with any card image writer, such as balenaEtcher or Raspberry Pi Imager ("Use custom"). Both read the .gz directly.

TETSU-DATA

An image writer only writes the image, so the card has no TETSU-DATA until the device's first start adds it, which takes about a second longer behind the logo. A card that had Tetsu OS before keeps its games and saves there. Anything else 4 GiB into the card is erased, as writing an image erases a card anyway. The card needs at least 6 GiB.

Option B: flash.sh on Linux ​

scripts/flash.sh writes the image and adds TETSU-DATA in one go, and refuses disks that look internal or are mounted. Unmount the card's partitions first, then:

bash
scripts/flash.sh

lists the disks. Find your card by its size, then:

bash
scripts/flash.sh /dev/sdX

It shows the card's partitions and asks before writing. Use --format-data to also erase the games and saves on TETSU-DATA:

bash
scripts/flash.sh --format-data /dev/sdX

Cards from before the rename

A card flashed before 2026-11-08 has a data partition named RGDATA. It needs --format-data once; copy your saves off it first.

3. First boot ​

Put the card in the TF1 slot and press the power button. You'll see the Tetsu OS logo, then, with the boot jingle on, an animation of the kettle.

A new install starts with a short setup, one step per screen:

The setup's first step, choosing the language

  1. Language: English or German. Up and Down switch at once.
  2. Wi-Fi: join a network, or skip. Network time sets the clock once connected.
  3. Time: your time zone and 12 or 24 hour clock. Choosing German preselects Berlin.
  4. Games: connect the USB cable to show TETSU-DATA as a drive on your computer, or send games over Wi-Fi from a browser. See Adding games.

A goes on, B goes back, and Start finishes from any step: everything here is also in Settings, and Settings > ADVANCED > RUN SETUP AGAIN repeats it.

Freedoom and Cave Story are copied to your games on the first start, so the home screen has something to play right away.

What's on the card ​

PartitionNameSizeContents
1TETSU-BOOT128 MiB, FATBoot logs, the bootloader's settings and a README. Readable on any computer
2TETSU-ROOT1 GiBSystem slot A, with the kernel
31 GiBSystem slot B, empty until the first update
4TETSU-DATAthe rest, FAT32Games, saves, covers, settings. See Files on TETSU-DATA

Removing Tetsu OS ​

Take the card out. The device boots its stock firmware from its own card again. To reuse the card, copy what you want from TETSU-DATA and format it on your computer.

Tetsu OS is released under the MIT license. Emulator cores keep their own licences.