SCUMMVM(6)

okay so this is scummvm(6) from the Games Manual, bestie — the page for the interpreter that plays a whole bunch of adventure and role-playing games built on a variety of game engines. Strap in, because there are a lot of options and we are covering every single one. 💅

✨ NAME ✨

scummvm — adventure and role-playing game interpreter. That's the whole vibe, no cap. 🦋

🌸 SYNOPSIS 🌸

scummvm [OPTIONS] [GAME]

💖 DESCRIPTION 💖

scummvm is an interpreter that will play numerous adventure and role-playing games based on a variety of game engines. Literally its whole thing.

GAME is the short name of the game to load. It can be either a built-in gameid (as given by --list-games), or a user-configured target (as given by --list-targets). Slay.

✨ 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. Bestie, that's the override cheat code. 🔥

• -a, --add — add all games from current or specified (with --path=PATH) directory. If --game=ID is passed, only the game with id ID is added. See also --detect.
• -b, --boot-param=NUM — pass number NUM to the boot script, for games supporting this feature.
• -c, --config=CONFIG — use alternate configuration file path.
• -d, --debuglevel[=NUM] — enable and set debug verbosity level (default: 0).
• -e, --music-driver=MODE — select music driver:
  • adlib — internal AdLib emulation.
  • alsa — output using ALSA sequencer device.
  • core — CoreAudio sound (macOS).
  • coremidi — CoreMIDI sound (macOS).
  • fluidsynth — FluidSynth MIDI emulation.
  • mt32 — internal MT-32 emulation.
  • null — null output. Don't play any music.
  • pcjr — internal PCjr emulation.
  • pcspk — internal PC Speaker emulation.
  • seq — use /dev/sequencer for MIDI (some Unix systems).
  • sndio — use sndio MIDI.
  • timidity — connect to TiMidity++ MIDI server.
  • towns — internal FM-TOWNS YM2612 emulation (only usable in SCUMM FM-TOWNS games). Use only if you have a hardware MIDI synthesizer.
  • windows — Windows built-in MIDI sequencer (Windows).
• -F, --no-fullscreen — force windowed mode.
• -f, --fullscreen — force full-screen mode.
• -g, --gfx-mode=MODE — select graphics mode (opengl, surfacesdl).
• -h, --help — display a brief help text, and exit.
• -i, --initial-cfg=CONFIG — load an initial configuration file if no configuration file has been saved yet.
• -l, --logfile=PATH — use alternate path for log file.
• -m, --music-volume=NUM — set the music volume, 0–255 (default: 192).
• -n, --[no-]subtitles — enable subtitles (for games that have voice).
• -p, --path=PATH — set the path to where the game is installed.
• -q, --language=LANG — select game's language:
  • ar — Arabic (Modern Standard)
  • eu — Basque
  • bg — Bulgarian
  • ca — Catalan
  • zh — Chinese (Generic)
  • cn — Chinese (Simplified)
  • tw — Chinese (Traditional)
  • hr — Croatian
  • cs — Czech
  • da — Danish
  • nl — Dutch
  • en — English (Generic, default)
  • gb — English (Great Britain)
  • us — English (US)
  • et — Estonian
  • fi — Finnish
  • be — Flemish
  • fr — French
  • fr-ca — French (Canada)
  • de — German
  • el — Greek
  • he — Hebrew
  • hu — Hungarian
  • it — Italian
  • ja — Japanese
  • ko — Korean
  • lv — Latvian
  • lt — Lithuanian
  • nb — Norwegian (Bokmål)
  • fa — Persian
  • pl — Polish
  • br — Portuguese (Brazil)
  • pt — Portuguese (Portugal)
  • ru — Russian
  • sr — Serbian
  • sk — Slovak
  • es — Spanish
  • sv — Swedish
  • tr — Turkish
  • uk — Ukrainian
• -r, --speech-volume=NUM — set the voice volume, 0–255 (default: 192).
• -s, --sfx-volume=NUM — set the SFX volume, 0–255 (default: 192).
• -t, --list-targets — display list of user-configured game targets, and exit.
• -u, --dump-scripts — enable script dumping if a directory called dumps exists in the current directory.
• -v, --version — display ScummVM version information, and exit.
• -x, --save-slot[=SLOT] — set the saved game slot to load (default: 0 = autosave).
• -z, --list-games — display list of supported games, and exit.
• --[no-]alt-intro — toggle alternative intro for CD versions of Beneath a Steel Sky and Flight of the Amazon Queen (default: disabled).
• --[no-]aspect-ratio — toggle aspect ratio correction.
• --auto-detect — display a list of games from current or specified directory, and start the first one. Use --path=PATH to specify a directory.
• --cdrom=DRIVE — set the drive to play CD audio from; can either be a drive, path, or numeric index (default: 0 = best choice drive).
• --[no-]copy-protection — enable copy protection in games, when ScummVM disables it by default.
• --[no-]dirtyrects — toggle dirty rectangles optimisation in software renderer (default: enabled).
• --debug-channels-only — show only the specified debug channels.
• --debugflags=FLAGS — enable engine specific debug flags (separated by commas).
• --[no-]demo-mode — toggle demo mode of Maniac Mansion or The 7th Guest (default: disabled).
• --detect — display a list of games with their ID from current or specified directory without adding it to the configuration file. Use --path=PATH to specify a directory.
• --dump-midi — dump MIDI events to dump.mid (overwriting it), until quitting from game.
• --enable-gs — enable patch mappings to emulate an MT-32 on a Roland GS device for MIDI playback.
• --engine=ID — in combination with --list-games, --list-all-games, --list-targets, or --stats, only list games for this engine. Multiple engines can be listed separated by a coma.
• --engine-speed=NUM — set frame per second limit (0–100) for 3D games, 0 = no limit (default: 60).
• --[no-]exit — in combination with commands that exit after running, like --add or --list-engines, toggle opening the launcher instead of exiting.
• --extrapath=PATH — set the extra path to additional game and ScummVM data.
• --[no-]filtering — force filtered/unfiltered graphics mode. Filtered graphics mode uses bilinear interpolation while unfiltered graphics mode uses nearest neighbor.
• --game=ID — in combination with --add or --detect, only add or attempt to detect the game with id ID.
• --gui-theme=THEME — select a GUI theme, as given by --list-themes.
• --joystick[=NUM] — enable joystick input (default: 0 = first joystick).
• --iconspath=PATH — set the path to additional icons for the launcher grid view.
• --list-all-debugflags — display list of all engine debugflags, and exit.
• --list-all-engines — display list of all detection engines, and exit.
• --list-all-games — display list of all detected games, and exit.
• --list-audio-devices — list all available audio devices, and exit.
• --list-debugflags[=ENGINE] — display list of engine specified debugflags, and exit. If the ENGINE argument is “global”, or if it is not specified, list global debugflags.
• --list-engines — display list of supported 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, and exit.
• --list-themes — display list of all usable GUI themes, and exit.
• --md5 — show MD5 hash of the file given by --md5-path=PATH. If --md5-length=NUM is passed, then show the MD5 hash of the first (if positive) or last (if negative) NUM bytes of the file given by PATH. If --md5-engine=ENGINE_ID is passed, fetch the MD5 length automatically, overriding --md5-length.
• --md5mac — like --md5, but for old Macintosh files. Show MD5 hash for both the resource fork and data fork of the file.
• --midi-gain=NUM — set the gain for MIDI playback, 0–1000 (default: 100). Only supported by some MIDI drivers.
• --multi-midi — enable combination of AdLib and native MIDI.
• --native-mt32 — tell ScummVM that the MIDI device is an actual Roland MT-32 or compatible device. This disables any GM emulation.
• --opl-driver=DRIVER — select AdLib (OPL) emulator (alsa, db, mame, nuked, opl2lpt).
• --output-channels=RATE — set output channel count (e.g. 2 for stereo).
• --output-rate=RATE — set output sample rate in Hz (e.g. 22050).
• --platform=PLATFORM — specify platform of game (2gs, 3do, acorn, amiga, android, apple2, atari, atari8, beos, c64, cdi, coco, coco3, cpc, fmtowns, ios, linux, macintosh, macintosh2, megadrive, nes, os2, pc, pc98, pce, pippin, playstation, playstation2, ppc, saturn, segacd, shockwave, ti994, wii, windows, xbox, zx).
• --random-seed=NUM — set the random seed number used to initialize entropy.
• --[no-]recursive — in combination with --add or --detect, recurse down all subdirectories (default: disabled).
• --render-mode=MODE — enable additional render modes (2gs, amiga, atari, c64, cga, cgaBW, cgaComp, cpc, ega, fmtowns, hercAmber, hercGreen, macintosh, macintoshbw, pc9801, pc9821, vga, zx).
• --renderer=RENDERER — select 3D renderer (opengl, opengl_shaders, software).
• --savepath=PATH — specify where saved games are stored.
• --scale-factor=FACTOR — set the factor to scale the graphics by.
• --scaler=MODE — select graphics scaler (normal, hq, edge, advmame, sai, supersai, supereagle, pm, dotmatrix, tv2x).
• --screenshotpath=PATH — specify path where screenshot files are created.
• --[no-]show-fps — toggle FPS info in 3D games.
• --soundfont=FILE — select the SoundFont for MIDI playback (only supported by some MIDI drivers).
• --start-movie=NAME@NUM — start movie at frame for Director 🎬 either argument can be specified without the other, no cap.
• --stats — display statistics about engines and games, and exit 📊 like a little stats girlie pop-off.
• --stretch-mode=MODE — select stretch mode: center, even-pixels, fit, fit_force_aspect, pixel-perfect, stretch ✨ pick your vibe.
• --talkspeed=NUM — set talk delay for SCUMM games, or talk speed for other games 💬 yes, it does both.
• --tempo=NUM — set music tempo (in percent, 50–200) for SCUMM games (default: 100) 🎵 tempo queen behavior.
• --themepath=PATH — set the path to GUI themes 🎀 make it cute.
• --window-size=W,H — set the window size to the specified dimensions (W,H) (OpenGL only) 🪟 literally only OpenGL, bestie.

🎮 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 mode 🖥️
• Alt-s — take a screenshot 📸
• Ctrl-F7 — open virtual keyboard (if available). This can also be triggered by a long press of the middle mouse button or wheel ⌨️
• Ctrl-Alt d — open the ScummVM debugger 🐛

There are many more game-specific hotkeys. See: https://wiki.scummvm.org/index.php?title=Category:Supported_Games 👀

🌱 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 🎧
• SCUMMVM_SAVEPATH — override the default save path (POSIX systems) 💾

📁 FILES 📁

• $HOME/.config/scummvm/scummvm.ini — configuration file on most Unix systems. XDG environment variables take precedence, if defined 🗂️
• $HOME/Library/Preferences/ScummVM Preferences — configuration file on macOS 🍏

🎬 EXAMPLES 🎬

Running the built-in 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 and subtitles (with the dig-steam target already defined in the configuration file):

$ scummvm --scaler=advmame --scale-factor=2 -n dig-steam

Running the Italian version of Maniac Mansion fullscreen, from the content of the current directory:

$ scummvm -q it -f scumm:maniac

👀 SEE ALSO 👀

https://docs.scummvm.org — the docs, bestie, go read ’em 📚

💖 AUTHORS 💖

ScummVM was written by the ScummVM team. See AUTHORS file for more information 🫶

---

And that’s the tea ☕ — this page is from the Debian build, dated June 13, 2023, for SCUMMVM(6) 💅✨