From DOSBoxWiki
Revision as of 17:43, 26 October 2010 by Ykhwong (talk | contribs) (also for a joystick)
Jump to navigationJump to search


When you start the keymapper (either with CTRL-F1 or -startmapper as a commandline argument to the DOSBox executable) you are presented with a virtual keyboard and a virtual joystick. These virtual devices correspond to the keys and events DOSBox will report to the DOS applications. If you click on a button with your mouse, you can see in the lower left corner with which event it is associated (EVENT) and to what events it is currently bound.

  • EVENT: The key DOSBox will report to the applications being emulated.
  • BIND: The key on your keyboard (as reported by SDL) which is connected to the EVENT.
  • mod1,2,3: Modifiers. These are keys you need to have pressed as well, while pressing BIND. mod1 = CTRL and mod2 = ALT. These are generally only used when you want to change the special keys of DOSBox.
  • Add: Add a new BIND to this EVENT. Basicly add a key from your keyboard which will produce the key EVENT in DOSBox.
  • Del: Delete the BIND to this EVENT. If an EVENT has no BINDS than it's not possible to type this key in DOSBox.
  • Next: Cycle through the list of keys(BINDS) which map to this EVENT.


Q1. You want to have the X on your keyboard to type a Z in DOSBox.

   A. With your mouse click on the Z on the keyboard mapper. Click "Add". Now press the X key
   on your keyboard.

Q2. If you click "Next" a few times you will notice that the Z on your keyboard also produces a Z in DOSBox.

   A. Therefore select the Z again and click "Next" till you have the Z on your keyboard. Now
   click "Del".

Q3. If you try it out in DOSBox you will notice that pressing X makes ZX appear.

   A. The X on your keyboard is still mapped to the X as well! Click on the X in the keyboard
   mapper and search with "Next" till you find the mapped key X. Click "Del".

If you change the default mapping you can save your changes by pressing "Save". DOSBox will save the mapping to location specified in the configfile (mapperfile=mapper.txt). At startup DOSBox will load your mapperfile if it's present in the configfile.