Command Line Options
ScummVM can be accessed through the command line. This section talks about the different command line options. The meaning of most long options (that is, those options starting with a double-dash) can be inverted by prefixing them with “no-“. For example, --no-aspect-ratio
will turn aspect ratio correction off. This is useful if you want to override a setting in the configuration file.
The short game name (‘game target’) you see at the end of the command line specifies which game is started. It either corresponds to an arbitrary user defined target (from the configuration file), or to a built-in gameid.
General Options
[GAME] Short name of game to load. For example, 'monkey'
for Monkey Island. This can be either a built-in
gameid, or a user configured target.
-v, --version Display ScummVM version information and exit
-h, --help Display a brief help text and exit
-z, --list-games Display list of supported games and exit
-t, --list-targets Display list of configured targets and exit
--list-saves Display a list of saved games for the target specified
with --game=TARGET, or all targets if none is specified
-a, --add Add all games from current or specified directory.
If --game=ID is passed only the game with id ID is
added. See also --detect.
Use --path=PATH to specify a directory.
--detect Display a list of games with their ID from current or
specified directory without adding it to the config.
Use --path=PATH to specify a directory.
--game=ID In combination with --add or --detect only adds or attempts to
detect the game with id ID.
--auto-detect Display a list of games from current or specified directory
and start the first one. Use --path=PATH to specify
a directory.
--recursive In combination with --add or --detect recurse down all
subdirectories
--console Enable the console window (default: enabled) (Windows only)
-c, --config=CONFIG Use alternate configuration file
-p, --path=PATH Path to where the game is installed
Save Files
-x, --save-slot[=NUM] Saved game slot to load (default: autosave)
--savepath=PATH Path to where saved games are stored
--extrapath=PATH Extra path to additional game data
Graphics
-f, --fullscreen Force full-screen mode
-F, --no-fullscreen Force windowed mode
-g, --gfx-mode=MODE Select graphics scaler (see also section 5.3)
--stretch-mode=MODE Select stretch mode (center, integral, fit, stretch)
--filtering Force filtered graphics mode
--no-filtering Force unfiltered graphics mode
--aspect-ratio Enable aspect ratio correction
--render-mode=MODE Enable additional render modes (hercGreen, hercAmber,
cga, ega, vga, amiga, fmtowns, pc9821, pc9801, 2gs,
atari, macintosh)
GUI
--gui-theme=THEME Select GUI theme (default, modern, classic)
--themepath=PATH Path to where GUI themes are stored
--list-themes Display list of all usable GUI themes
Music & Sound
-e, --music-driver=MODE Select music driver (see also section 7.0)
--list-audio-devices List all available audio devices
-q, --language=LANG Select game's language (see also section 5.5)
-m, --music-volume=NUM Set the music volume, 0-255 (default: 192)
-s, --sfx-volume=NUM Set the sfx volume, 0-255 (default: 192)
-r, --speech-volume=NUM Set the voice volume, 0-255 (default: 192)
--midi-gain=NUM Set the gain for MIDI playback, 0-1000 (default: 100)
(only supported by some MIDI drivers)
--cdrom=NUM CD drive to play CD audio from (default: 0 = first
drive)
--soundfont=FILE Select the SoundFont for MIDI playback (Only
supported by some MIDI drivers)
--multi-midi Enable combination of AdLib and native MIDI
--native-mt32 True Roland MT-32 (disable GM emulation)
--enable-gs Enable Roland GS mode for MIDI playback
--output-rate=RATE Select output sample rate in Hz (e.g. 22050)
--opl-driver=DRIVER Select AdLib (OPL) emulator (db, mame, nuked)
--tempo=NUM Set music tempo (in percent, 50-200) for SCUMM games
(default: 100)
Subtitles
-n, --subtitles Enable subtitles (use with games that have voice)
Boot-params & Debugging
-b, --boot-param=NUM Pass number to the boot script (boot param)
-d, --debuglevel=NUM Set debug verbosity level
--debugflags=FLAGS Enable engine specific debug flags
(separated by commas)
-u, --dump-scripts Enable script dumping if a directory called 'dumps'
exists in the current directory
Joystick & Platform
--joystick[=NUM] Enable joystick input (default: 0 = first joystick)
--platform=WORD Specify platform of game (allowed values: 2gs, 3do,
acorn, amiga, atari, c64, fmtowns, mac, nes, pc,
pce, segacd, windows)
Miscellaneous
--alt-intro Use alternative intro for CD versions of Beneath a
Steel Sky and Flight of the Amazon Queen
--copy-protection Enable copy protection in games, when
ScummVM disables it by default.
--talkspeed=NUM Set talk delay for SCUMM games, or talk speed for
other games (default: 60)
--demo-mode Start demo mode of Maniac Mansion (Classic version)
Examples:
- Win32: Running Monkey Island, fullscreen, from a hard disk:
C:\Games\LucasArts\scummvm.exe -f -pC:\Games\LucasArts\monkey\ monkey
Running Full Throttle from CD, fullscreen and with subtitles enabled: C:\Games\LucasArts\scummvm.exe -f -n -pD:\resource\ ft - Unix: Running Monkey Island, fullscreen, from a hard disk:
/path/to/scummvm -f -p/games/LucasArts/monkey/ monkey
Running Full Throttle from CD, fullscreen and with subtitles enabled:/path/to/scummvm -f -n -p/cdrom/resource/ ft