Skip to content

Library Structure

Games are organized by platform in your library directories:

/games/
pc/
Hades II (2025)/
Celeste (2018) (igdb-26226)/
switch/
The Legend of Zelda Breath of the Wild (2017)/

Folder names are parsed for title, year, and an optional IGDB ID:

  • Game Title (Year) — matched automatically against IGDB
  • Game Title (Year) (igdb-NNNNN) — forces a specific IGDB match

Adding igdb-NNNNN is useful when automatic matching picks the wrong game.

Games can be:

  • Loose files — a directory containing the game files
  • A single archive — zip, tar, or tar.gz

Background scanning runs every 2 minutes to pick up changes in your library directories. You can also trigger a manual scan from the admin panel.