LaunchBox Built-in Command Line Variables
Written By Brian Faeran
Last updated 7 months ago
These built-in variables can be used across LaunchBox wherever command line arguments are accepted, including emulator settings, game-specific overrides, and more.
%romfile%
Description: Outputs the ROM file path depending on emulator settings:
Default: Full path to the ROM file, including quotes.
If Don't Use Quotes is checked: Outputs the path without quotes.
If Use File Name Only Without File Extension or Folder Path is checked: Outputs just the bare filename.
Note: If omitted, the ROM file will be placed at the end of the command line.
%platform%
Description: Outputs the game's platform name.
%launchboxorbigboxexepath%
Description: Outputs the full path to either LaunchBox.exe or BigBox.exe, depending on which one is currently running.
%gameid%
Description: Outputs the unique GUID for the game as stored in the XML data.
%romlocation%
Description: Outputs the path to the ROM location, including quotes. Example: "C:\Games\ROMs\NES"
%romfilename%
Description: Outputs the filename of the ROM without its file extension. Example: SuperMarioWorld
%romextension%
Description: Outputs just the file extension of the ROM. Example: .zip, .cue, etc.
%romlocation_noquotes%
Description: Outputs the ROM location path without surrounding quotes.
%noromfile%
Description: Replaced with an empty string. Prevents LaunchBox from automatically appending the ROM file to the end of the command line.
Note: This list may expand with future LaunchBox updates. If you're building plugins or integrating external systems, always test your arguments to ensure correct substitution.