From DOSBoxWiki
Revision as of 13:14, 4 April 2008 by (talk) (we needed this in the Wiki, an explanation of the keymapper functionality)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
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. This virtual keyboard corresponds with the keys DOSBox will report to its applications. If you click on a key with your mouse, you can see in the lowerleft corner which key on your keyboard corresponds with it.

  • 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 an 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.