User Manual/Appendix: Config file description

From ScummVM :: Wiki
< User Manual
Revision as of 21:27, 12 September 2017 by Criezy (talk | contribs) (Fix error for the icon file format on Windows)
Jump to navigation Jump to search
If you want to contribute, send us a sample of text you'd write for the new manual, and we will consider adding you an account. You can work on the manual in the Wiki, but if you prefer, supplying us with HTML or TeX sources is fine, too (we will then translate them for the Wiki).

You can have a look at our TODO page for a list of tasks that need to be done.


Normally, ScummVM’s configuration file does not need to be modified directly, as all options are adjustable from the ScummVM GUI. However, there are some advanced options only available by editing the configuration file directly:

INI Section Name Description
scummvm output_rate Overrides the audio output sampling frequency. The default value is 44100.
scummvm audio_buffer_size Overrides the size of the audio buffer. This can be decreased if audio latency is high, or increased if audio drop-outs are experienced. The value must be one of: 256 512 1024 2048 4096 8192 16384 32768. The default value is calculated based on output sampling frequency to keep audio latency below 45ms.
scummvm joystick_num Number of joystick device to use for input.
scummvm last_fullscreen_mode_width
Specify the resolution to use on fullscreen when using the OpenGL graphics mode. This is used internally to remember the last resolution used, and reuse it the next time we go to fullscreen. This can also be set manually to a desired fullscreen resolution.
scummvm disable_display Can be used to disable display when replaying events using the event recorder.
scummvm screenshotpath Indicate the path where to saved the screenshot. The default is system-dependent.
scummvm iconspath Indicate the path where to look for game icons for task bar integration on Windows and macOS X. The game icons are used as overlay for the ScummVM icon in the taskbar / Dock when a game is running. The icons files should be named after the game ids and be .ico on Windows and .png on macOS X.
scummvm console Enable or disable the console on Windows. By default it is enabled.

Prev: Appendix: Command line options Back to Table of Content Next: Appendix: Tools