Skip to content

🔥🔥🔥 You are viewing a development version of the website. Things will blow up. 🔥🔥🔥

Regular users, please follow the exit signs.

# Keymapper reference

The table below lists every mappable action in DOSBox Staging. Actions with no default binding can be assigned to any key or button combination through the key mapper.

Event name | Description | Default (Win/Linux) | Default (macOS)
--- | --- | --- | ---
`mapper` | Open key mapper | `Ctrl`+`F1` | `Cmd`+`F1`
`shutdown` | Exit DOSBox | `Ctrl`+`F9` | `Cmd`+`F9`
`fullscr` | Toggle fullscreen | `Alt`+`Enter` | `Alt`+`Enter`
`restart` | Restart DOSBox | `Ctrl`+`Alt`+`Home` | `Cmd`+`Ctrl`+`Home`
`pause` | Pause emulation | `Alt`+`Pause` | `Cmd`+`P`
`capmouse` | Toggle mouse capture | `Ctrl`+`F10` | `Cmd`+`F10`
`mute` | Mute audio | `Ctrl`+`F8` | `Cmd`+`F8`
`speedlock` | Toggle turbo speed | `Alt`+`F12` | `Alt`+`F12`
`cycledown` | Decrease CPU cycles | `Ctrl`+`F11` | `Cmd`+`F11`
`cycleup` | Increase CPU cycles | `Ctrl`+`F12` | `Cmd`+`F12`
`reloadshader` | Reload current shader | `Ctrl`+`F2` | `Cmd`+`F2`
`stretchax` | Toggle stretch axis | (none) | (none)
`incstretch` | Increase viewport stretch | (none) | (none)
`decstretch` | Decrease viewport stretch | (none) | (none)
`previmageadj` | Select previous image adjustment | (none) | (none)
`nextimageadj` | Select next image adjustment | (none) | (none)
`decimageadj` | Decrease image adjustment | (none) | (none)
`incimageadj` | Increase image adjustment | (none) | (none)
`screenshot` | Screenshot (default format) | `Ctrl`+`F5` | `Cmd`+`F5`
`rawshot` | Raw screenshot | (none) | (none)
`upscshot` | Upscaled screenshot | (none) | (none)
`rendshot` | Rendered screenshot | `Alt`+`F5` | `Alt`+`F5`
`recwave` | Record audio | `Ctrl`+`F6` | `Cmd`+`F6`
`caprawmidi` | Record MIDI | `Ctrl`+`Alt`+`F6` | `Cmd`+`Alt`+`F6`
`video` | Record video | `Ctrl`+`F7` | `Cmd`+`F7`
`caprawopl` | Record OPL output | (none) | (none)
`swap` | Swap disk image | `Ctrl`+`F4` | `Cmd`+`F4`
`hercpal` | Cycle Hercules palette | `F11` | `F11`
`monocgapal` | Cycle mono CGA palette | `F11` | `F11`
`comp_sel` | Select composite knob | `F10` | `F10`
`comp_inc` | Increase composite control | `F11` | `F11`
`comp_dec` | Decrease composite control | `Alt`+`F11` | `Alt`+`F11`
`cgacomp` | Toggle CGA composite mode | `F12` | `F12`
`debugger` | Enable debugger | `Alt`+`Pause` | `Alt`+`Pause`
`jxsl` | Joystick X scalar left | `Ctrl`+`Left` | `Cmd`+`Left`
`jxsr` | Joystick X scalar right | `Ctrl`+`Right` | `Cmd`+`Right`
`jxol` | Joystick X offset left | `Alt`+`Left` | `Alt`+`Left`
`jxor` | Joystick X offset right | `Alt`+`Right` | `Alt`+`Right`
`jxrs` | Joystick X reset | `Ctrl`+`Del` | `Cmd`+`Del`
`jysd` | Joystick Y scalar down | `Ctrl`+`Down` | `Cmd`+`Down`
`jysu` | Joystick Y scalar up | `Ctrl`+`Up` | `Cmd`+`Up`
`jyod` | Joystick Y offset down | `Alt`+`Down` | `Alt`+`Down`
`jyou` | Joystick Y offset up | `Alt`+`Up` | `Alt`+`Up`
`jyrs` | Joystick Y reset | `Ctrl`+`Home` | `Cmd`+`Home`

Note

Video adapter-specific actions (`hercpal`, `monocgapal`, `comp_sel`, `comp_inc`, `comp_dec`, `cgacomp`) are only active when the corresponding machine type is emulated.

Joystick calibration actions are only active when `use_joy_calibration_hotkeys` is enabled.