Configuration

Global configuration file

Settings for steam-dos can be found in ~/.config/steam-dos.conf (or wherever XDG_CONFIG_HOME points to). Most of the settings from that file can be overridden using environment variables.

If you want to edit DOSBox configuration for a specific game instead, you can edit user configuration file in game's installation directory.

confgen.force

Set this value to true if you want steam-dos to re-create DOSBox user configuration on every run. This option is useful mostly for development purposes. Defaults to: false

midi.enable

This option is used to control the start of software MIDI synthesiser for all games. You can override value for specific game with SDOS_NO_MIDI. Defaults to: true

midi.soundfont

The filename of a soundfont file used by software MIDI synthesiser. steam-dos will search for a soundfont in ~/.local/share/soundfonts/, ~/.local/share/sounds/sf2/ and in default system-wide locations.

Defaults to: FluidR3_GM.sf2. If not found, then default.sf2.

dosbox.fullscreenmode

• screen <num>, where <num> is the number of the display you want to use. Run $ xrandr --listmonitors to learn what numbers you can use. You can override value for specific game with SDOS_SCREEN. Defaults to screen 0, which is your primary display.
• desktop The whole desktop area will be used (all displays) with the game centred, the native resolution of your displays will be preserved. This is a fallback value in case screen detection won't work.

dosbox.scaler

Pick the default scaler, that you want to use for all games. You can override selection per-game by changing option render.scaler in user .conf file in game's installation dir. You can see the full list of available options with visualisation on DOSBox wiki.

Defaults to: normal3x

dosbox.cmd

Change the command, that you use to run DOSBox. For example:

To run DOSBox, that you compiled yourself:

cmd = ~/path_to_dosbox/src/dosbox

To run DOSBox-X fork installed from snap store:

cmd = snap run dosbox-x

You can override value for specific game with SDOS_DOSBOX_CMD. Defaults to: dosbox

dosbox.bin

Old name for dosbox.cmd, used in steam-dos 0.3.3 and older.

DOSBox configuration

DOSBox configuration files are incompatible between different operating systems. steam-dos interprets Windows-specific .conf files supplied by the game publisher and translates them to Linux-specific files. It also improves them by introducing runtime-specific values, environment variables and game tweaks to work around some DOSBox and game limitations.

To accomplish this, configuration is split into two files: automatic file (generated anew with every start of the game) and user file (generated on the first run only).

Configuration files are generated in the current working directory - for Steam games this is usually (but not always) game's top-level installation directory.

Global DOSBox configuration files (stored e.g. in ~/.dosbox) do NOT affect any game started through steam-dos.

Automatic .conf file

These files are named steam_dos_auto.conf and reflect steam-dos user settings and runtime state of the machine when the game is starting.

Values in this file can be overriden by editing user .conf file:

User .conf file

These files are named steam_dos_<appid>_<hash>.conf, user can override any DOSBox configuration value here (but take note, that future DOSBox versions might use incompatible configuration values).

Games that provide more than one launcher option through the Steam launcher will generate several user conf files, each with different value of <hash>.

Environment and configuration variables

These variables can be set in Steam client. For example, to force game to use your secondary screen, right-click your game in Steam Library, select Properties → Set Launch Options… and set: SDOS_SCREEN=1 %command%.

Name	Values	Description
SDOS_DOSBOX_CMD	command	Use this command to run the game. Overrides value in dosbox.cmd setting.
SDOS_NO_MIDI	0 or 1	Set 1 to turn off software MIDI synthesiser.
SDOS_NO_MIDI_PRESET	0 or 1	Set 1 to prevent patching of game files.
SDOS_RUN_EXE	path to file	Set path to executable file to be launched instead of Steam-selected one. Example: SDOS_RUN_EXE="GAME/SETUP.EXE" %command%
SDOS_SCREEN	number	Set to the number of the screen, that you want the game to use.
SDOS_SIERRA_GAME	number	Set to the number of the game in Sierra Launcher, that you want to start. Check SierraLauncher.ini file in the game's installation dir to learn which number corresponds to which game. Defaults to 1.