scummvm - Man Page
graphic adventure game interpreter
Synopsis
scummvm | [Options] [GAME] |
Description
scummvm is an interpreter that will play graphic adventure games based on a variety of game engines.
GAME is a short name of game to load. For example, scumm:monkey for Monkey Island. This can be either a built-in gameid, or a user configured target.
Options
Please note that more detailed information for the following options can be found in the README file.
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.
- -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.
- -t, --list-engines
Display list of suppported engines 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
- -c, --config=CONFIG
Use alternate configuration file.
- -p, --path=PATH
Path to where the game is installed.
- -x, --save-slot=[SLOT]
Saved game slot to load (default: autosave).
- -f, --fullscreen
Force full-screen mode.
- -F, --no-fullscreen
Force windowed mode.
- -g, --gfx-mode=MODE
Select graphics scaler:
- 1x
No filtering, no scaling. Fastest.
- 2x
No filtering, factor 2x (default for non 640x480 games).
- 3x
No filtering, factor 3x.
- 2xsai
2xSAI filter, factor 2x.
- super2xsai
Enhanced 2xSAI filtering, factor 2x.
- supereagle
Less blurry than 2xSAI, but slower. Factor 2x.
- advmame2x
Doesn't rely on blurring like 2xSAI, fast. Factor 2x.
- advmame3x
Doesn't rely on blurring like 2xSAI, fast. Factor 3x.
- hq2x
Very nice high quality filter but slow. Factor 2x.
- hq3x
Very nice high quality filter but slow. Factor 3x.
- tv2x
Interlace filter, tries to emulate a TV. Factor 2x.
- dotmatrix
Dot matrix effect. Factor 2x.
- --stretch-mode=MODE
Select stretch mode (center, integral, fit, stretch)
- --filtering
Force filtered graphics mode
- --no-filtering
Force unfiltered graphics mode
- --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
- -e, --music-driver=MODE
Select music driver:
- null
Null output. Don't play any music.
- adlib
Internal AdLib emulation
- fluidsynth
FluidSynth MIDI emulation
- mt32
Internal MT-32 emulation
- pcjr
Internal PCjr emulation (only usable in SCUMM games)
- pcspk
Internal PC Speaker emulation
- towns
Internal FM-TOWNS YM2612 emulation (only usable in SCUMM FM-TOWNS games)
- alsa
Output using ALSA sequencer device
- core
CoreAudio sound, for macOS users
- coremidi
CoreMIDI sound, for macOS users. Use only if you have a hardware MIDI synthesizer.
- seq
Use /dev/sequencer for MIDI, *nix users.
- timidity
Connect to TiMidity++ MIDI server.
- windows
Windows built in MIDI sequencer for Windows users
- --list-audio-devices
List all available audio devices
- -q, --language=LANG
Select game's language:
- cz
Czech
- de
German
- en
English (USA) (default)
- es
Spanish
- fr
French
- gb
English (Great Britain)
- hb
Hebrew
- it
Italian
- jp
Japanese
- kr
Korean
- pt
Portuguese
- ru
Russian
- se
Swedish
- zh
Chinese
- -m, --music-volume=NUM
Set the music volume, 0-255 (default: 192).
- -s, --sfx-volume=NUM
Set the sfx volume to, 0-255 (default: 192).
- -r, --speech-volumeNUM
Set the voice volume to, 0-255 (default: 192).
- --midi-gain=NUM
Set the gain for MIDI playback, 0-1000 (default: 100)
(only supported by some MIDI drivers)- -n, --subtitles
Enable subtitles (use with games that have voice).
- -b, --boot-param=NUM
Pass number to the boot script (boot param).
- -d, --debuglevel=NUM
Set debug verbosity level
- --debugflags=Arm 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.
- --cdrom=NUM
CD drive to play CD audio from (default: 0 = first drive).
- --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)
- --savepath=PATH
Path to where saved games are stored
- --extrapath=PATH
Extra path to additional game data
- --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 MIDI (disable GM emulation).
- --enable-gs
Enable Roland GS mode for MIDI playback.
- --output-rate=RATE
Set output sample rate in Hz (e.g. 22050).
- --opl-driver=DRIVER
Select AdLib (OPL) emulator (db, mame, nuked)
- --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)
- --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)
- --tempo=NUM
Set music tempo (in percent, 50-200) for SCUMM games (default: 100).
Ingame Hotkeys
- Ctrl-F5
Display the Global Menu
- Cmd-q
Quit (macOS)
- Ctrl-q
Quit (Most platforms)
- Ctrl-u
Mute all sounds
- Ctrl-m
Toggle mouse capture
- Ctrl-Alt 1-8
Switch between graphics filters
- Ctrl-Alt +
Increase scale factor
- Ctrl-Alt -
Decrease scale factor
- Ctrl-Alt a
Toggle aspect-ratio correction
- Ctrl-Alt f
Toggle graphics filtering
- Ctrl-Alt s
Cycle through scaling modes
- Alt-Enter
Toggle full screen/windowed
- Alt-s
Make a screenshot (SDL backend only)
- Ctrl-F7
Open virtual keyboard (if enabled). This can also be triggered by a long press of the middle mouse button or wheel.
There are many more SCUMM and game-specific hotkeys. See the README file.
Environment
- SCUMMVM_MIDI
The sequencer device to use with the ‘
seq
’ MIDI driver.- SCUMMVM_MIDIPORT
The number of the sequencer to use when using the ‘
seq
’ MIDI driver.- SCUMMVM_PORT
The ALSA port to open for output when using the ‘
alsa
’ MIDI driver.
Files
- $HOME/.scummvmrc
Configuration file on UNIX.
- $HOME/Library/Preferences/ScummVM Preferences
Configuration file on macOS.
Examples
Running the builtin game launcher:
$ scummvm
Running Day of the Tentacle specifying the path:
$ scummvm -p /usr/local/share/games/tentacle scumm:tentacle
Running The Dig with advmame2x filter with subtitles:
Running the Italian version of Maniac Mansion fullscreen:
See Also
More information can be found in the README and on the website https://www.scummvm.org
.
Authors
This manual page written by Jonathan Gray <khalek at scummvm.org>. ScummVM was written by the ScummVM team. See AUTHORS file for more information.