Platform Naming and Rename Patterns
Questarr places downloaded games under a platform folder inside your Library Root. The Rename Pattern in Settings → Import names the game folder or, for a single-file import, the file beneath that platform folder. For example, with/games as the Library Root and {Title} ({Year}) as the
pattern, a PC game might be imported to:
{Platform} to a pattern repeats that folder’s name in the game name; it does
not change the platform folder itself. Importing existing games through
Library → Library Import does not rename or move their files.
See Library Import for transfer modes, path mappings, and
manual review.
Platform keys and folder names
The table below lists the platform naming catalog used by download imports. Platform keys are internal lowercase labels, sometimes called slugs. Spaces are intentional:xbox series and wii u are not hyphenated URL slugs. You do not
need to enter these keys in the rename pattern or rename existing directories to
match them.
The Folder / {Platform} column gives both the platform directory name and
the value inserted by the {Platform} token. IGDB IDs identify platforms in the
platform selection setting. This catalog is not a complete list of every
platform available from IGDB.
How Questarr chooses the platform
- A recognized platform in the download’s release title takes priority. For
example,
Example.Game.PS5selects thePS5folder, even if the game is also available on PC. - Without a recognized release platform, Questarr uses the first game platform
that matches the platform selection. Stored IGDB names such as
PC (Microsoft Windows)resolve to the catalog’s IDs. For a game listing PlayStation 3 before PC, selecting only PC still chooses thePCfolder. - If no selected game platform is found, folder planning uses the first game
platform value it can resolve to an ID. If the chosen ID has no folder mapping,
or no ID can be resolved, the folder is
PC. It does not check later IDs just because the chosen ID has no folder mapping. This naming fallback does not bypass the automatic import filter.
Rename-pattern tokens
Tokens use braces and are case-insensitive:{Title} and {title} are
equivalent. Literal text outside tokens is retained, subject to filename
sanitization.
The default pattern is
{Title} ({Region}). Because Region is currently empty,
this normally produces just the title.
Examples
Assuming a game named The Example Quest, released in 2024, with platform folder PC, IGDB ID 12345, and a release title containingGOG:
Missing values and filename rules
- Missing metadata renders empty. Brackets containing only empty tokens and orphan separators at the beginning or end are removed.
- A pattern names one path segment. Slashes,
.., unknown tokens, control characters, and unbalanced or nested braces are rejected. - Filename characters such as
:,?, and*are replaced with underscores. Trailing spaces and dots are removed, Windows reserved names are prefixed with_, and the name is limited to 200 UTF-8 bytes. - When an unusable pattern or empty result reaches the naming engine, it falls
back to the sanitized game title, or
Unknownif the title is also unusable.