Skip to content

The rebase

Letalys edited this page Sep 20, 2026 · 2 revisions

Français · English

The rebase

The rebase copies the checked games to the destination, following the chosen target architecture. Rebase to…, in the main window, opens the window below.

Rebase window

The table at the bottom tells what will be written for each game, before anything is copied.


Destination and architecture

  • Destination: the SD card, the USB drive or the folder that will receive the games
  • Preconfigured target architecture: sets the folder names and the rules of each system. See Target architectures

Files

Setting Role
Archives Extract as the architecture requires (recommended): only the systems whose emulator cannot read archives are extracted. Never extract: everything is copied as is. Extract everything (except romsets): every archive is extracted
Extracted files Automatic: a single extracted file takes the name of the game, several files go to a folder named after the game. One folder per game: always a folder
Convert files with external tools Enables the conversions of the Conversion column. See External tools

Metadata

Setting Role
Copy covers Copies the cover of each game to the folder set by the architecture
Generate… Writes the metadata file of the target. The label carries its name: gamelist.xml, miyoogamelist.xml
Back up the existing file Keeps a dated copy of the existing file, for example gamelist.xml.20260920
Metadata language French or English. A description missing in French is taken in English

An existing metadata file is merged: the games already listed and the favorites are kept.


Copy

Setting Role
If file exists Ignore: the file already there is left alone. Overwrite: it is replaced
Concurrent copies Number of games copied at the same time. On an SD card, 2 to 4 is enough
Retry attempts Number of new tries after a failure
Retry delay Wait, in seconds, between two tries

The games table

Column Content
Romset The archive is copied under its original name, with no extraction and no M3U. Required for arcade
M3U A playlist gathers the discs of the game
Extraction The archive is extracted instead of being copied
Conversion The external tool that will convert the game, or None
Output What will be written. On hover: the list of files
Status Ready, then Copying, Extracting or Converting, and finally Done, Skipped or Failed
Error The reason of a failure, or a warning about a cover, followed by its error code

The button at the end of the row removes the game from this rebase and unchecks it in the library.

Choosing a conversion for one game

Values of the Output column

Value Meaning
Copy The file is copied under the name of the game
2 discs + M3U The discs are numbered and gathered in a playlist
2 versions Several versions of the same game (PAL, NTSC, revision), named after their RomStation label, with no playlist
Game folder DOS or Windows game: its whole folder is copied
Converted to .chd The game goes through an external tool
No mapping The architecture has no folder for this system: the game will be skipped

Setting one game apart

Romset, M3U, Extraction and Conversion are pre-filled by the architecture and can be changed row by row for the current rebase, without modifying the architecture.

A rule that does not apply to the game is off and greyed out, and its tooltip tells why.


During the rebase

  • Start launches the copy, after checking the destination, the available room and the systems with no mapping
  • Pause suspends copies between two files
  • Cancel stops everything. A running extraction or conversion is cleaned up, a plain copy may leave an incomplete file: see Limitations
  • Show log opens the rebase log

At the end

Rebase done
End message

A message sums up the result and the table keeps the status of each game. Open folder shows the destination in Explorer.


What ends up on the card

With the ArkOS / dArkOS architecture, covers and metadata enabled:

gba\
    Advance Wars.zip
    Castlevania- Aria of Sorrow.zip
    gamelist.xml
    images\
        Advance Wars-image.png
        Castlevania- Aria of Sorrow-image.png
n64\
    Super Mario 64.zip
    gamelist.xml
    images\
        Super Mario 64-image.png
psx\
    Alundra.m3u
    gamelist.xml
    .Alundra\
        Alundra.cue
        Alundra.bin
    images\
        Alundra-image.png
snes\
    EarthBound.zip
    Mega Man X.zip
    Secret of Mana.zip
    gamelist.xml
    images\
        EarthBound-image.png
        Mega Man X-image.png
        Secret of Mana-image.png

A multi-disc game:

psx\
    Chrono Cross.m3u
    .Chrono Cross\
        Chrono Cross (Disc 1).cue
        Chrono Cross (Disc 1).bin
        Chrono Cross (Disc 2).cue
        Chrono Cross (Disc 2).bin
  • A cartridge stays in its zip
  • A Playstation game is extracted. With the Hidden folder option of the architecture, its files go to a folder whose name starts with a dot and EmulationStation lists only the M3U
  • The internal names of a multi-file archive are kept
  • A character that Windows forbids in file names is replaced: Castlevania: Aria of Sorrow becomes Castlevania- Aria of Sorrow
  • RSRebase never deletes anything on the destination. See Limitations

Clone this wiki locally