Collections, Arch R

archr-launcher has two cross-system collections at the top of the Systems screen, shown only when they have at least one game:

Favorites (@favorites): every game you marked as a favorite, from any system.
Recent (@recent): up to 30 of the games you opened most recently, newest first.

Systems with no games in their folder are hidden.

Buttons in a game list

Button	Action
A	Start the selected game
B	Back to the Systems screen
X	Add to or remove from Favorites
Y	Quick menu for the game (Core, Details, Saves, Screenshots, Achievements, MangoHud; each only when it applies)
L1 / R1	Previous / next page

These are the default buttons; they can be changed in Settings › Controls › Launcher.

Favorites

Press X on a game in a list, or the Favorite button on the Game details screen, to toggle its star.

Once at least one game is a favorite, Favorites appears on the Systems screen.
On the Systems screen, the card of the selected system shows its number of games and of favorites.

Recent

Every time you start a game, archr-launcher puts it at the front of Recent, keeping up to 30 entries without duplicates. Entries from Tools are not recorded.

You can open Recent from its entry on the Systems screen, or from the Recent tile of the Start Menu (START).

Imported metadata

The first time archr-launcher loads a system, it imports from that system's gamelist.xml (the one EmulationStation used):

games with <favorite>true</favorite> into Favorites;
games with <lastplayed> into Recent, after the games started from archr-launcher itself.

This happens once per system. After that, favorites and recents belong to the launcher and are not written back to gamelist.xml.

Reordering systems and collections

You can choose the order of Favorites, Recent and the systems on the Systems screen:

Start moving a row

On the Systems screen, highlight the collection or system to move, press Y and choose Move.

Choose the new position

Use Up / Down (and, in a carousel view such as Showcase, also Left / Right or L1 / R1) to move the row. The footer shows the row and its position (Moving <name> · position X of Y).

Save or cancel

Press A to save the new order, or B to put the row back where it was.

To go back to the default order (Favorites and Recent first, then the systems with games in catalog order), press Y on the Systems screen and choose Restore default order. That item only appears when a custom order is saved.

Where it is stored

/storage/.config/archr-launcher/store.toml

archr-launcher writes store.toml atomically. Games are stored as <system>/<path relative to the system folder>:

favorites = [
  "snes/Chrono Trigger.zip",
  "psx/Vagrant Story.chd",
]
recent = [
  "snes/Chrono Trigger.zip",
  "gba/Metroid Fusion.zip",
]
order = [
  "@favorites",
  "@recent",
  "snes",
  "psx",
  "gba",
]

The file also records which systems were already imported. If you edit it by hand over SSH, stop the launcher first so it does not overwrite your changes:

systemctl stop archr-launcher-session
# edit /storage/.config/archr-launcher/store.toml
systemctl start archr-launcher-session

Collections

On this page