Skip to content

Troubleshooting

Jump to bottom
Letalys edited this page Sep 20, 2026 · 2 revisions

Français · English

Troubleshooting

Every RSRebase error message ends with a code, such as [RSR-3004]. The Error codes page lists them all.

At startup

RomStation is not detected (RSR-1001)

RomStation is installed as a portable ZIP, or was uninstalled or moved.

  • Click Browse… and select the root folder of RomStation, the one that contains RomStation.cfg

The RomStation database is not initialized (RSR-1002)

RomStation was never launched on this machine.

  • Launch RomStation once, let it start completely, then restart RSRebase

The RomStation database is locked (RSR-1004)

RomStation, or a database tool such as DBeaver, is open at the same time as RSRebase.

  • Close RomStation and any tool reading its database, then restart RSRebase

Corrupted configuration file (RSR-1005, RSR-1006)

  • app-state.json: click Continue. The file is recreated
  • user-preferences.json: click Reset. Language, theme and last rebase settings return to their default values

No target architecture defined (RSR-2005)

Every architecture was deleted.

  • Open Settings, Edit preconfigured architectures…, then Restore default architectures

During a rebase

The destination folder is invalid or not found (RSR-2002, RSR-2003, RSR-2010)

The typed path is incomplete or relative, or the media is no longer connected.

  • Check that Windows sees the media, then pick the destination again with Browse…

Not enough disk space (RSR-2007, RSR-2008, RSR-3004)

  • Free some space, reduce the selection, or choose Never extract if the target reads archives
  • Not enough space in the work folder message: free some space on the local disk. A conversion needs room for the largest game, extracted, in %LOCALAPPDATA%\RomStationRebase\work

Some games end up as "Failed" (RSR-3xxx)

  • Look up the code of the Error column in the Error codes page. The rebase log keeps the full error message
  • "source file not found" (RSR-3001) on several games: run Sync RomStation DB
  • Error on the destination: check that the media is connected, that there is room left and that it is not write-protected

Games are marked "No mapping"

The chosen architecture has no folder for their system. Those games are skipped.

The Conversion column only offers "None"

  • The executable of the tool is not set: open Manage external tools…
  • No tool reads the content of the game. This is the case of a Dreamcast game shipped as .cdi, see Limitations
  • The game is a romset or a game in a folder

A conversion fails (RSR-4xxx)

The game is marked Failed and the other games carry on. The rebase log keeps the command line and what the tool printed. Common causes:

  • Tool version too old: the Test button of the tools window reports it
  • Local disk full
  • Incomplete RomStation archive

On the device

The copied games do not show up

  • Check that the card is the one the device reads for games. Under ArkOS and dArkOS with two cards, the games are on the second one
  • In EmulationStation, UI SETTINGS menu: START ON SYSTEM and HIDE SYSTEM VIEW can limit the display to a single system
  • Restart EmulationStation or reboot the device

A game shows up several times, or as a folder to open

EmulationStation lists the M3U and each of its discs, or the folder of an extracted game.

  • Enable Hidden folder for multi-file games in the architecture, see Target architectures
  • On the device, keep the EmulationStation option that shows hidden files turned off
  • Games copied before that change stay where they were

A Playstation or Dreamcast game does not start

  • Check that the system is marked Extract in the architecture: a CUE and its BIN inside a zip do not load
  • A multi-disc game is launched through its .m3u file
  • Swapping discs in game: open the RetroArch menu, then Disc Control. On an Anbernic RG353V running dArkOS, the menu opens with Select + X

My RomStation saves are not on the device

RSRebase transfers neither in-game saves nor save states. They stay in RomStation, see Limitations.

An arcade game does not start

FBNeo and MAME refuse a renamed romset.

  • Enable Keep name for arcade, Neo-Geo, Naomi and Atomiswave in the architecture
  • Check that the expected BIOS (neogeo.zip for example) is present on the device

During a sync

The sync fails: database locked (RSR-1009)

  • Close RomStation and any tool reading its database, then run Sync RomStation DB again

In the game details

"Open folder": folder not found

The game was moved or deleted in RomStation since the last sync.

  • Run Sync RomStation DB

After updating RSRebase

A default architecture was fixed, but mine did not change

An update does not overwrite architectures.

  • Click Restore default architectures in the architecture editor. Custom architectures are left alone, changes made to a default architecture are lost

The application closes on an error (RSR-9001, RSR-9003)

The detail of the error is written to a RSR_crash_….txt file, in %LOCALAPPDATA%\RomStationRebase\logs. Attach it to the issue.

Problem not listed

Open an issue on the GitHub repository with the Bug report template, and give:

  • The RSRebase version, shown in Settings
  • The RomStation version
  • The steps to reproduce the problem
  • The error message shown with its code, and the rebase log if it is about a copy

RomStation Rebase

Français

English

Dernière version / Latest release

Clone this wiki locally