Skip to content

Files on TETSU-DATA ​

TETSU-DATA is a FAT32 partition, readable on any computer through a card reader or USB STORAGE. On the device it is /mnt/data.

WARNING

Change settings through the menus, not by editing settings.txt on the device while the launcher runs: the launcher keeps them in memory and would write over your change.

Folders ​

FolderContents
roms/Your games, in any folders
roms/.discs/Lists the launcher writes for grouped PlayStation discs
saves/Saves, save states, resume points, play time and per-game settings
boxart/Covers, as .ppm pictures of up to 200x300
screenshots/Screenshots from the in-game menu, as PNG
cheats/<console>/RetroArch .cht cheat files, such as cheats/snes/
core-options/Core options set per console
achievements/Badges, and answers kept for playing offline
ssh/The root password hash and SSH keys
.syncthing/Syncthing's keys and database, while SAVE BACKUP is used

A game's files in saves ​

Saves are named after the game's file, so Tetris.gb has:

FileWhat it is
Tetris.gb.srmThe game's own save (battery memory)
Tetris.gb.state1 … .state8Save state slots
Tetris.gb.resumeWhere you left off
Tetris.gb.srm.playtimePlay time in seconds
Tetris.gb.srm.controlsThe game's own button layout
Tetris.gb.srm.optionsThe game's own core options
Tetris.gb.srm.cheatsCheats turned on
Tetris.gb.srm.achievementsAchievement count for the details screen
Tetris.gb.srm.achievements-offAchievements turned off for this game
Tetris.gb.srm.noticesWhere this game's achievement notices show

Game Boy Advance games keep <name>.srm without the extension, and the Tamagotchi keeps tama.state, from before this naming. A game in a ZIP uses the name of the game inside with the ZIP's name, so zipping a game keeps its saves.

Files at the top ​

FileWhat it is
settings.txtAll settings, one key=value per line
settings-backup.txtThe settings before their last change, used if settings.txt is damaged
recent.txtThe RECENT list
favorites.txtStarred games
collections.txtYour collections
hidden-games.txtHidden games
playing.txtThe game running, so it resumes after a power-off
play-log.txtPlay time per day and console, for STATISTICS
battery-log.txt, battery-stats.txtThe battery log
wpa_supplicant.confSaved Wi-Fi networks and passwords
retroachievements.txtYour RetroAchievements name and token
bundled-games.txtWhich included games were copied, so deleted ones stay deleted
update-pending.txtThe slot and build of an update being tried

TETSU-BOOT ​

The first partition, also FAT, holds:

  • bootlog.txt: written about 15 and 60 seconds after each start, with the screen, backlight, launcher and kernel messages. The first place to look when something is wrong.
  • logs/: written by SYSTEM INFO's save logs (X): launcher.log, dmesg.txt and system.txt. Passwords and keys are left out.
  • uboot.env, uboot-redund.env: the bootloader's settings, with the A/B boot order.
  • README.txt

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