Keyboard mapping

Not all Amiga keys are present on modern computer keyboards, and vice versa. Most keys are mapped like you would expect (F1 on your keyboard activates F1 on the emulated Amiga keyboard, etc).

Here are some notable exceptions:

Amiga Help = End (Mac laptops: Fn + Right)
Amiga Delete = Delete (Mac laptops: Fn + Backspace)
Amiga Numpad Left Paren = Home (Mac laptops: Fn + Left)
Amiga Numpad Right Paren = Page Up (Mac laptops: Fn + Up)
Amiga Left A = Page Down or Right Menu / Right Windows key.
Amiga Right A = Left Menu / Left Windows key.
Amiga Ctrl = Left Ctrl
Amiga key to the left of Backspace = Insert

Emulator keyboard shortcuts are documented on a separate page.

Keys in FS-UAE are (generally) mapped based on physical location and not by symbol. Trying to map symbols would require hack-ish workarounds, since one Amiga key can have its symbols spread over two or more host keys, depending on keyboard layout.

To to understand how to use the emulated Amiga keyboard, it is useful to visualize that you have printed stickers for Amiga keys, and pasted them on top of your keyboard keys, in the corresponding physical location.

Please note the following important information:

Amiga key names are based on what the physical key location is called on an US/UK Amiga keyboard.
Similarly, host key names are based on what the physical key location is called on an US/UK Amiga keyboard.

If you have a non-English keyboard, you need to compare your keyboard to an English one to find out what a key in a given physical location is called. Likewise, you must use an English Amiga keyboard as reference to understand what a specific Amiga key is named.

Note: Since the Amiga keys are listed in row order, you can also use this order to figure out the correct name for non-English keys. For host keys, you can refer to the separate table in the "Host Key names" section.

Amiga keys

The Amiga keys are listed in row order, top row first. The listed action names in the table are for use with custom input mapping. The host key name is printed in bold letters when the physical location of the host key differs from the Amiga key.

| Amiga Key | Input Mapping Action | ------------ | ------------------------- | ESC | action_key_esc | F1 | action_key_f1 | F2 | action_key_f2 | F3 | action_key_f3 | F4 | action_key_f4 | F5 | action_key_f5 | F6 | action_key_f6 | F7 | action_key_f7 | F8 | action_key_f8 | F9 | action_key_f9 | F10 | action_key_f10 | - | | | BACKQUOTE | action_key_backquote | 1 | action_key_1 | 2 | action_key_2 | 3 | action_key_3 | 4 | action_key_4 | 5 | action_key_5 | 6 | action_key_6 | 7 | action_key_7 | 8 | action_key_8 | 9 | action_key_9 | 0 | action_key_0 | SUB | action_key_sub | EQUALS | action_key_equals | BACKSLASH | action_key_backslash | BACKSPACE | action_key_backspace | DEL | action_key_del | HELP | action_key_help | LPAREN | action_key_lparen | RPAREN | action_key_rparen | NP_DIV | action_key_div | NP_MUL | action_key_mul | - | | | TAB | action_key_tab | Q | action_key_q | W | action_key_w | E | action_key_e | R | action_key_r | T | action_key_t | Y | action_key_y | U | action_key_u | I | action_key_i | O | action_key_o | P | action_key_p | LEFTBRACKET | action_key_leftbracket | RIGHTBRACKET | action_key_rightbracket | RETURN | action_key_return | NP_7 | action_key_np_7 | NP_8 | action_key_np_8 | NP_9 | action_key_np_9 | NP_SUB | action_key_sub | - | | | CTRL | action_key_ctrl | CAPS_LOCK | action_key_caps_lock | A | action_key_a | S | action_key_s | D | action_key_d | F | action_key_f | G | action_key_g | H | action_key_h | J | action_key_j | K | action_key_k | L | action_key_l | SEMICOLON | action_key_semicolon | SINGLEQUOTE | action_key_singlequote | 2B | action_key_2b | CURSOR_UP | action_key_cursor_up | NP_4 | action_key_np_4 | NP_5 | action_key_np_5 | NP_6 | action_key_np_6 | NP_ADD | action_key_add | - | | | SHIFT_LEFT | action_key_shift_left | 30 | action_key_30 | Z | action_key_z | X | action_key_x | C | action_key_c | V | action_key_v | B | action_key_b | N | action_key_n | M | action_key_m | COMMA | action_key_comma | PERIOD | action_key_period | DIV | action_key_div | SHIFT_RIGHT | action_key_shift_right | CURSOR_LEFT | action_key_cursor_left | CURSOR_DOWN | action_key_cursor_down | CURSOR_RIGHT | action_key_cursor_right | NP_1 | action_key_np_1 | NP_2 | action_key_np_2 | NP_3 | action_key_np_3 | NP_ENTER | action_key_enter | ALT_LEFT | action_key_alt_left | AMIGA_LEFT | action_key_amiga_left | SPACE | action_key_space | AMIGA_RIGHT | action_key_amiga_right | ALT_RIGHT | action_key_alt_right | NP_0 | action_key_np_0 | NP_PERIOD | action_key_period | Default Host Key(s)............ | | ------------------------------- | | ESCAPE | | F1 | | F2 | | F3 | | F4 | | F5 | | F6 | | F7 | | F8 | | F9 | | F10 | | BACKQUOTE | | 1 | | 2 | | 3 | | 4 | | 5 | | 6 | | 7 | | 8 | | 9 | | 0 | | MINUS | | EQUALS | | BACKSLASH | | BACKSPACE | | DELETE | | END | | HOME | | PAGEUP | | KP_DIVIDE | | KP_MULTIPLY | | TAB | | Q | | W | | E | | R | | T | | Y | | U | | I | | O | | P | | LEFTBRACKET | | RIGHTBRACKET | | RETURN | | KP7 | | KP8 | | KP9 | | KP_MINUS | | LCTRL | | CAPSLOCK | | A | | S | | D | | F | | G | | H | | J | | K | | L | | SEMICOLON | | QUOTE | | INSERT | | UP | | KP4 | | KP5 | | KP6 | | KP_PLUS | | LSHFT | | LESS | | Z | | X | | C | | V | | B | | N | | M | | COMMA | | PERIOD | | SLASH | | RSHIFT | | LEFT | | DOWN | | RIGHT | | KP1 | | KP2 | | KP3 | | KP_ENTER | | LALT | | LSUPER | | SPACE | | RSUPER, PAGEDOWN, MENU | | RALT | | KP0 | | KP_PERIOD |

FIXME map MENU to ALT_LEFT instead?
FIXME Alt and Amiga mappings

The keys named "2B and "30" in this list is for international Amiga keyboards which has these physical keys:

Amiga key code 0x2B is the key between SINGLEQUOTE and RETURN.
Amiga key code 0x30 is the key between LSHIFT and Z.

Note: It is often possible to change the keyboard layout in Workbench (or other programs) running in the emulated Amiga. This will not affect the names of the keys used in input mapping. In fact, FS-UAE will be unaware of such a setting, and it will work just like it would with a real Amiga and a real Amiga keyboard. I.e. if you change keyboard layout in Amiga emulation you can get a different symbol when you press a given key.

Host key names

| Host Key | Input Mapping Option | Comment...................... | | ------------ | --------------------------- | ----------------------------- | | - | | Function key row | | ESCAPE | keyboard_key_escape | | F1 | keyboard_key_f1 | | F2 | keyboard_key_f2 | | F3 | keyboard_key_f3 | | F4 | keyboard_key_f4 | | F5 | keyboard_key_f5 | | F6 | keyboard_key_f6 | | F7 | keyboard_key_f7 | | F8 | keyboard_key_f8 | | F9 | keyboard_key_f9 | | F10 | keyboard_key_f10 | | F11 | keyboard_key_f11 | | F12 | keyboard_key_f12 | | PRINT | keyboard_key_print | Labelled F13 on Apple A1243 | | SCROLLOCK | keyboard_key_scrollock | Labelled F14 on Apple A1243 | | PAUSE | keyboard_key_pause | Labelled F15 on Apple A1243 | | F16 | keyboard_key_f16 | Apple A1243 keyboard | | F17 | keyboard_key_f17 | Apple A1243 keyboard | | F18 | keyboard_key_f18 | Apple A1243 keyboard | | F19 | keyboard_key_f19 | Apple A1243 keyboard | | - | | Number row | | BACKQUOTE | keyboard_key_backquote | | 1 | keyboard_key_1 | | 2 | keyboard_key_2 | | 3 | keyboard_key_3 | | 4 | keyboard_key_4 | | 5 | keyboard_key_5 | | 6 | keyboard_key_6 | | 7 | keyboard_key_7 | | 8 | keyboard_key_8 | | 9 | keyboard_key_9 | | 0 | keyboard_key_0 | | MINUS | keyboard_key_minus | | EQUALS | keyboard_key_equals | | BACKSPACE | keyboard_key_backspace | | INSERT | keyboard_key_insert | | HOME | keyboard_key_home | | PAGEUP | keyboard_key_pageup | | NUMLOCK | keyboard_key_numlock | | KP_DIVIDE | keyboard_key_kp_divide | | KP_MULTIPLY | keyboard_key_kp_multiply | | KP_MINUS | keyboard_key_kp_minus | | - | | Top letter row | | TAB | keyboard_key_tab | | Q | keyboard_key_q | | W | keyboard_key_w | | E | keyboard_key_e | | R | keyboard_key_r | | T | keyboard_key_t | | Y | keyboard_key_y | | U | keyboard_key_u | | I | keyboard_key_i | | O | keyboard_key_o | | P | keyboard_key_p | | LEFTBRACKET | keyboard_key_rightbracket | | RIGHTBRACKET | keyboard_key_rightbracket | | RETURN | keyboard_key_return | | DELETE | keyboard_key_delete | | END | keyboard_key_end | | PAGEDOWN | keyboard_key_pagedown | | KP7 | keyboard_key_kp7 | | KP8 | keyboard_key_kp8 | | KP9 | keyboard_key_kp9 | | KP_PLUS | keyboard_key_kp_plus | | - | | Middle letter row | | CAPSLOCK | keyboard_key_capslock | | A | keyboard_key_a | | S | keyboard_key_s | | D | keyboard_key_d | | F | keyboard_key_f | | G | keyboard_key_g | | H | keyboard_key_h | | J | keyboard_key_j | | K | keyboard_key_k | | L | keyboard_key_l | | SEMICOLON | keyboard_key_semicolon | | QUOTE | keyboard_key_quote | | BACKSLASH | keyboard_key_backslash | | KP4 | keyboard_key_kp4 | | KP5 | keyboard_key_kp5 | | KP6 | keyboard_key_kp6 | | - | | Bottom letter row | | LSHIFT | keyboard_key_lshift | | LESS | keyboard_key_less | | Z | keyboard_key_z | | X | keyboard_key_x | | C | keyboard_key_c | | V | keyboard_key_v | | B | keyboard_key_b | | N | keyboard_key_n | | M | keyboard_key_m | | COMMA | keyboard_key_comma | | PERIOD | keyboard_key_period | | SLASH | keyboard_key_slash | | RSHIFT | keyboard_key_rshift | | UP | keyboard_key_up | | KP1 | keyboard_key_kp1 | | KP2 | keyboard_key_kp2 | | KP3 | keyboard_key_kp3 | | KP_ENTER | keyboard_key_kp_enter | | - | | Bottom row | | LCTRL | keyboard_key_lctrl | | LSUPER | keyboard_key_lsuper | Left "Windows" key or "Cmd" | | LALT | keyboard_key_lalt | Different phys. pos. on Mac | | SPACE | keyboard_key_space | | RALT | keyboard_key_ralt | Different phys. pos. on Mac | | RSUPER | keyboard_key_rsuper | Right "Windows" key or "Cmd" | | MENU | keyboard_key_menu | | RCTRL | keyboard_key_rctrl | | LEFT | keyboard_key_left | | DOWN | keyboard_key_down | | RIGHT | keyboard_key_right | | KP0 | keyboard_key_kp0 | | KP_PERIOD | keyboard_key_kp_period | | - | | Special keys | | VOLUMEUP | keyboard_key_volumeup | | VOLUMEDOWN | keyboard_key_volumedown | | MUTE | keyboard_key_mute | | AUDIONEXT | keyboard_key_audionext | | AUDIOPREV | keyboard_key_audioprev | | AUDIOSTOP | keyboard_key_audiostop | | AUDIOPLAY | keyboard_key_audioplay |

14 thoughts on “Keyboard mapping”

Patrick Eaton on 2022-02-11 at 20:21 said:

Hi, Thank You for the great work. I have a small keyboard, no numeric keypad, but it has arrow keys. I get no response pressing any arrow keys tested with AmigaBASIC:
A$ = “”
WHILE (A$ “Q”)
A$ = INKEY$
IF (A$ “”) THEN
PRINT ASC(A$)
END IF
WEND

Pressing the ‘a’ key gives 97 as expected. Pressing Shift ‘a’ (A) gives 65 also as expected. But pressing any of the arrow keys does nothing. Can you suggest where to look for the problem?
I’m running Debian GNU/Linux Bullseye
HyperX keyboard

Reply ↓
- FrodeSolheim on 2022-03-03 at 17:08 said:
  
  Hi, this is probably because the arrow keys are used for joystick emulation. Either insert “nothing” into the joystick ports, or connect a gamepad to free the cursor keys for the keyboard emulation.
  
  Reply ↓
Antony on 2021-09-25 at 23:51 said:

Hello everyone.
Congratulations on this emulator which I find wonderful.
Excuse my pronunciation, but I write from Italy.
I would like to know if it is possible to remap the key on the keyboard “Alt Gr” or the “Right Ctrl” key by default which are used to fire, with a key of my choice, such as the letter “q”.
I tried to write:
Keyboard_key_q = action fire

Unfortunately it doesn’t work.
I also tried:

Keyboard_key_q = action_ctrl

It doesn’t work the same.
Can you help me?
I use the Fs-Uae Launcher 3.05 version

Thank you all.

Reply ↓
- FrodeSolheim on 2021-11-18 at 09:06 said:
  
  Hi, you can do something like this: keyboard_key_q = action_joy_1_fire_button
  This will specifically make the key Q press the fire button on the main Amiga joystick (in port 1).
  
  Reply ↓
dodo on 2021-07-22 at 02:35 said:

Thanks for your hard work! This is a great program!

If you have time, a question:
I mapped joystick up, down, etc… to my keypad. Is it possible to map diagonal movements to keypad 9, 7, 3, and 1? For example jstick up + jsick right to keypad 9, and so on? If so, how do I phrase it in my config file?

Reply ↓
- dodo on 2021-07-22 at 02:42 said:
  
  Please disregard. I found the command in input actions. Sorry!
  
  Reply ↓
joshua on 2021-03-20 at 17:02 said:

Hi, I have a joystick controller (Generic USB Joystick) and I create the following config:

[fs-uae-controller]
name = Generic USB Joystick
platform = windows

[device]
make = ArcadeJoy
model = CustomForMame2
type = gamepad

[sdl]
guid = 03000000790000000600000000000000
buttons = 12
hats = 1
axes = 5
balls = 0

[default]
include = universal_gamepad
axis_0_neg = lstick_left
axis_0_pos = lstick_right
axis_1_neg = lstick_up
axis_1_pos = lstick_down
button_0 = south_button
button_1 = east_button
button_2 = north_button
button_3 = west_button
button_6 = select_button
button_8 = start_button
button_9 = menu_button

how can I map to a button the amiga space key and to another button the F12 PC host key?

I tried actions but they don’t work.

Thanks

Reply ↓
- FrodeSolheim on 2021-03-20 at 17:07 said:
  
  Once you have set up this file, you can add something like this to the global settings in FS-UAE Launcher for example:
  
  joystick_0_north_button = action_key_space joystick_1_north_button = action_key_space
  
  You cannot map a button to a host key, but you can map it to one of the supported actions.
  
  Reply ↓
  - Juppstein on 2021-07-09 at 20:58 said:
    
    Can this also be done on a per game basis or only in the global config file?
    
    Reply ↓
    - FrodeSolheim on 2021-11-18 at 09:32 said:
      
      It can be specified in .fs-uae config files as well, but not for entries from the database currently. A solution for this is forthcoming (in FS-UAE Launcher 4).
      
      Reply ↓
Jeffrey Stephen Dyer on 2020-10-21 at 15:10 said:

How about Shifted keys, for example some Amigas have HASH/POUND instead of single quote?

Reply ↓
- FrodeSolheim on 2021-03-20 at 17:05 said:
  
  The actions refer to the physical keys themselves, the names are based on the English layout, but that’s just the names. So just find out what the corresponding physical key on an English Amiga keyboard is called, and refer to that. What symbol this will result in on the Amiga depends on the keymap configured in Workbench.
  
  Reply ↓
Klearchos 'muadib' Gourgourinis on 2020-06-10 at 10:42 said:

Hi,
A rather unusual question,
In a computer with 2 keyboards connected, can I lock FS-UAE to take input from only one of them?

Thanks in advance!

Reply ↓
- FrodeSolheim on 2020-06-10 at 10:43 said:
  
  No, sorry :-/
  
  Reply ↓

FS-UAE Amiga Emulator

Documentation

Keyboard mapping

Amiga keys

Host key names