Change Keyboard Mapping

Changing the keyboard mapping (what key pressed on the typing keyboard activates what note on the music keyboard) is easy to do, and easy to save.

Unfortunately, this is done entirely in graphics, so this functionality is not currently accessible to the blind.

Here's how you re-map your keyboard's music keys.

Go to the F1 (Help / Setup) panel (shown below).

Screen-shot of the F1 (Help / Setup) pane.  The keyboard mapping graphics area is at the right.
The keyboard diagram shows the currently-defined keyboard mappings, as loaded from the selected keyboard map file in the “Keyboard Map” drop-box.

It consists of a keyboard diagram, with a column of characters in its left side. These characters are the keyboard-characters used to activate the various music keys. Only the white keys (keys of the scale) are mapped, since the application takes care of whether or not a black key is played, based on the current key-signature.

The upper-case characters immediately to the left of the keyboard keys are the letter-names of the notes. The short lines extending into the note-name area mark the boundaries between keyboard rows. If you are using a custom keyboard-map file (not ending with “-Z.kbd”, “-Z1.kbd”, or “-Z2.kbd”), the application doesn't know where to put these lines, so they will not appear.

You change the keyboard mapping by clicking somewhere in the keyboard map diagram (on the first key you want to change) . The application will ask you if you really want to change it, in case the click was accidental.

The keyboard diagram shows which keyboard key is used to activate which key of the music keyboard. To change it, click on the key of the diagram you want to change the mapping for, then type the key you want to use for it. When you change even a single key, the “Save Keybd Map” button is enabled, allowing you to save your keyboard map file (with a “.kbd” extension).

When you type a key into the keyboard map diagram, the selected key automatically moves up to the next key, making it easy to re-map entire groups of notes, or even the entire keyboard. If you want to change the entire keyboard mapping, click first on the lowest key.

Press the typing keyboard key you want to use to activate the selected key. As a result of doing this, the key you typed will appear to the left of the key that was marked, and the marked key will advance upward, allowing you to repeat the process on the newly-marked key.

Continue the process until you have changed the mapping for all of the music keys you wanted to change. You can skip around by clicking on different keys.

Finally, click on (tab-to and activate) the “Save Keybd Map” button, and select a filename for saving your keyboard map. If you want it to appear in the “Keyboard Map” drop-box, it will need to be saved in the “KeyMusician-Keyboard” directory of your home directory.

Back to Index

Next Documentation Page