The configuration file

The configuration file provides a way to edit both global and game-specific settings by using a text file containing configuration keywords and parameters.

Settings are also accessible directly from the Launcher . To edit global settings, click Options. To edit game-specific settings, highlight a game and then click Edit Game.

Location

The configuration file saves to different default locations, depending on the platform.

~/Library/Preferences/ScummVM Preferences, where ~ is your Home directory. To see the Libraries folder you will need to view hidden files.

Note that if an earlier version of ScummVM was installed on your system, the previous default location of ~/.scummvmrc will be kept.

95/98/ME: <windir>\scummvm.ini

Windows NT4: <windir>\Profiles\username\Application Data\ScummVM\scummvm.ini

<windir> refers to the Windows directory. Most commonly, this is C:\WINDOWS.

Windows 2000/XP: \Documents and Settings\username\Application Data\ScummVM\scummvm.ini

Window 7/Vista: \Users\username\AppData\Roaming\ScummVM\scummvm.ini

Note that if an earlier version of ScummVM was installed under Windows, the previous default location of <windir>\scummvm.ini will be kept.

We follow the XDG Base Directory Specification. This means our configuration can be found in $XDG_CONFIG_HOME/scummvm/scummvm.ini

If XDG_CONFIG_HOME is not defined or empty, ~/.config will be used, where ~ is your Home directory.

Note that .config is a hidden directory; to view it use ls -a on the command line. If you are using a GUI file manager, go to View > Show Hidden Files, or use the keyboard shortcut Ctrl + H.

If ScummVM was installed using Snap, the configuration file can be found at ~/snap/scummvm/current/.config/scummvm/scummvm.ini

See the relevant Platform page for details.

Using the configuration file

Global settings are listed under the [scummvm] heading. Global ../settings/keymaps settings are listed under the [keymapper] heading. Game-specific settings, including keymaps, are listed under the heading for that game, for example [queen] for Flight of the Amazon Queen. Use the configuration keywords to change settings.

Example of a configuration file

[scummvm]
gfx_mode=supereagle
fullscreen=true
savepath=C:\saves\

[sky]
path=C:\games\SteelSky\

[germansky]
gameid=sky
language=de
path=C:\games\SteelSky\
description=Beneath a Steel Sky w/ German subtitles

[germandott]
gameid=tentacle
path=C:\german\tentacle\
description=German version of DOTT

[tentacle]
path=C:\tentacle\
subtitles=true
music_volume=40
sfx_volume=255

[loomcd]
cdrom=1
path=C:\loom\
talkspeed=5
savepath=C:\loom\saves\

[monkey2]
path=C:\amiga_mi2\
music_driver=windows

Keywords

There are many recognized configuration keywords. In the table below, each keyword is linked to an explanatory description in the Settings pages.

Keyword

Type

Default

Options

alsa_port

number

alt_intro

boolean

false

altamigapalette

boolean

false

apple2gs_speedmenu

boolean

false

aspect_ratio

boolean

false

audio_buffer_size

number

Calculated

  • 256

  • 512

  • 1024

  • 2048

  • 4096

  • 8192

  • 16384

  • 32768

autosave_period

integer

300s

auto_savenames

boolean

false

bilinear_filtering

boolean

false

boot_param

number

none

bright_palette

boolean

true

cdrom

number

color

boolean

commandpromptwindow

boolean

false

confirm_exit

boolean

console

boolean

true

controller_map_db

string

copy_protection

boolean

false

demo_mode

boolean

false

description

string

disable_dithering

boolean

false

disable_stamina_drain

boolean

false

DurableArmor

boolean

false

EasyMouse

boolean

true

enable_black_lined_video

false

enable_censoring

boolean

false

enable_color_blind

boolean

false

enable_gore

boolean

enable_gs

boolean

enable_high_resolution_graphics

boolean

true

enable_hq_video

boolean

true

enable_larryscale

boolean

true

enable_video_upscale

boolean

true

enable_tts

boolean

false

extrapath

string

None

path

fade_style

boolean

true

filtering

boolean

false

floating_cursors

boolean

false

fluidsynth_chorus_activate

boolean

true

fluidsynth_chorus_depth

number

80

  • 0 - 210

fluidsynth_chorus_level

number

100

  • 0 - 100

fluidsynth_chorus_nr

integer

3

  • 0 - 99

fluidsynth_chorus_speed

number

30

  • 10 - 500

fluidsynth_chorus_waveform

string

Sine

  • sine

  • triangle

fluidsynth_misc_interpolation

string

4th

  • none

  • 4th

  • 7th

  • linear.

fluidsynth_reverb_activate

boolean

true

fluidsynth_reverb_damping

number

0

  • 0 - 1

fluidsynth_reverb_level

number

90

  • 0 - 100

fluidsynth_reverb_roomsize

number

20

  • 0 - 100

fluidsynth_reverb_width

number

1

  • 0 - 100

frames_per_secondfl

boolean

false

frontpanel_touchpad_mode

boolean

false

fullscreen

boolean

false

gameid

string

gamepath

string

gfx_mode

string

2x

  • 1x

  • 2x

  • 3x

  • 2xsai

  • super2xsai

  • supereagle

  • advmame2x

  • advmame3x

  • hq2x

  • hq3x

  • tv2x

  • dot-matrix

  • opengl

gm_device

string

null

  • auto

  • alsa

  • seq

  • sndio

  • fluidsynth

  • timidity

GraphicsDithering

boolean

true

gui_browser_native

boolean

true

helium_mode

boolean

false

help_style

boolean

false

herculesfont

boolean

false

hpbargraphs

boolean

true

hypercheat

boolean

false

iconpath

string

improved

boolean

true

InvObjectsAnimated

boolean

true

joystick_deadzone

integer

3

joystick_num

number

kbdmouse_speed

integer

10

keymap_engine-default_DOWN

string

JOY_DOWN

keymap_engine-default_LCLK

string

MOUSE_LEFT JOY_A

keymap_engine-default_LEFT

string

JOY_LEFT

keymap_engine-default_MCLK

string

MOUSE_MIDDLE

keymap_engine-default_MENU

string

F5 JOY_LEFT_SHOULDER

keymap_engine-default_PAUSE

string

SPACE

keymap_engine-default_PIND

string

keymap_engine-default_RCLK

string

MOUSE_RIGHT JOY_B

keymap_engine-default_RETURN

string

RETURN

keymap_engine-default_RIGHT

string

JOY_RIGHT

keymap_engine-default_SKIP

string

ESCAPE JOY

keymap_engine-default_SKLI

string

PERIOD JOY_X

keymap_engine-default_UP

string

JOY_UP

keymap_global_DEBUGGER

string

C+A+d

keymap_global_MENU

string

C+F5 JOY_START

keymap_global_MUTE

string

C+u

keymap_global_QUIT

string

C+q

keymap_global_VMOUSEDOWN

string

JOY_LEFT_STICK_Y+

keymap_global_VMOUSELEFT

string

JOY_LEFT_STICK_X-

keymap_global_VMOUSERIGHT

string

JOY_LEFT_STICK_X+

keymap_global_VMOUSESLOW

string

JOY_RIGHT_SHOULDER

keymap_global_VMOUSEUP

string

JOY_LEFT_STICK_Y-

keymap_gui_CLOS

string

ESCAPE JOY_Y

keymap_gui_DOWN

string

JOY_DOWN

keymap_gui_INTRCT

string

JOY_A

keymap_gui_LEFT

string

keymap_gui_RIGHT

string

JOY_RIGHT

keymap_gui_UP

string

JOY_UP

keymap_sdl-graphics_ASPT

string

C+A+a

keymap_sdl-graphics_CAPT

string

C+m

keymap_sdl-graphics_FILT

string

C+A+f

keymap_sdl-graphics_FLT1

string

C+A+1

keymap_sdl-graphics_FLT2

string

C+A+2

keymap_sdl-graphics_FLT3

string

C+A+3

keymap_sdl-graphics_FLT4

string

C+A+4

keymap_sdl-graphics_FLT5

string

C+A+5

keymap_sdl-graphics_FLT6

string

C+A+6

keymap_sdl-graphics_FLT7

string

C+A+7

keymap_sdl-graphics_FLT8

string

C+A+8

keymap_sdl-graphics_FULS

string

A+RETURN

keymap_sdl-graphics_SCL-

string

C+A+MINUS

keymap_sdl-graphics_SCL+

string

C+A+PLUS

keymap_sdl-graphics_SCRS

string

A+s

keymap_sdl-graphics_STCH

string

C+A+s

language

string

local_server_port

integer

12345

midi_gain

number

  • 0 - 1000

mm_nes_classic_palette

boolean

false

monotext

boolean

true

mousebtswap

boolean

false

mousesupport

boolean

true

mt32_device

string

  • auto

  • alsa

  • seq

  • fluidsynth

  • mt32

  • timidity

multi_midi

boolean

music_driver [scummvm]

string

auto

  • null

  • auto

  • seq (Unix)

  • sndio (Unix)

  • alsa (Unix)

  • CAMD (Amiga)

  • core (Mac)

  • coremidi (Mac - hardware)

  • windows (Windows)

  • fluidsynth

  • mt32

  • adlib

  • pcspk

  • pcjr

  • cms

  • timidity

music_driver [game]

string

auto

The same options as

music_driver in [scummvm]

plus:

  • towns

  • C64

  • pc98

  • segacd

music_volume

number

  • 0-256

mute

boolean

false

native_fb01

boolean

false

native_mt32

boolean

false

NaughtyMode

boolean

true

nodelaymillisfl

boolean

false

ntsc

boolean

object_labels

boolean

true

opl_driver

string

  • auto

  • mame

  • db

  • nuked

  • alsa

  • op2lpt

  • op3lpt

originalsaveload

boolean

false

output_rate

number

Sensible values are:

  • 11025

  • 22050

  • 44100

platform

string

portaits_on,

boolean

true

prefer_digitalsfx

boolean

true

render_mode

string

  • hercGreen

  • hercAmber

  • cga

  • ega

  • vga

  • amiga

  • fmtowns

  • pc9821

  • pc9801

  • 2gs

  • atari

  • macintosh

rootpath

string

savepath

string

save_slot

number

scalemakingofvideos

boolean

false

scanlines

boolean

false

screenshotpath

string

shorty

boolean

false

show_fps

boolean

false

ShowItemCosts

boolean

false

silver_cursors

boolean

false

sitcom

boolean

false

skip_support

boolean

true

skiphallofrecordsscenes

boolean

false

smooth_scrolling

boolean

true

speech_mute

boolean

false

stretch_mode

string

  • center

  • pixel-perfect

  • fit

  • stretch

  • fit_force_aspect

studio_audience

boolean

true

subtitles

boolean

false

talkspeed

number

60

  • 0 - 255

tempo

number

100

  • 50-200

TextWindowAnimated

boolean

true

themepath

string

none

transparent_windows

boolean

true

transparentdialogboxes

boolean

false

tts_enabled

boolean

false

tts_narrator

boolean

false

use_cdaudio

boolean

true

versioninfo

string

window_style

boolean

true

windows_cursors

boolean

false