Setting up Keyboard Controllers

From Amiberry 2.5 onwards, support is provided for universal gamepad / controller mapping.

There are two options available for this purpose:

• A standard USB or Bluetooth connected device, automatically detected by the host system
• Remapping of keyboard controls (or a keyboard controller device, such as Ultimarc's I-PAC devices) to act as a controller.

To use a regular controller as a joystick device, follow the details on the Setting up Input Controllers page.

Selecting a Keyboard Control Device

Under the Amiberry Input Panel, you can select any of the Amiga ports to Keyboard as Joystick [Default] to use this function.

The default layout for the keyboard mapping is as follows;

• North Button = Left Shift;
• East Button = Left Control
• South Button = Left Alt
• West Button = Spacebar
• D-pad Left = Cursor Left
• D-pad right = Cursor Right
• D-pad up = Cursor Up
• D-pad down = Cursor Down
• Left Shoulder Button = Z
• Right Shoulder Button = X
• Select Button = 1
• Start Button = 2
• Left 'Stick' Button = F1
• Right 'Stick' Button = F2

Customising the Keyboard Control Device

If you wish to change the layout of buttons used for the Keyboard mapping, you will require a RetroArch.cfg file to be read.

If you are using a pre-packaged system, such as RetroPie, controller mapping, you will have already had a RetroArch configuration set up, and you can skip this section.

If you require the creation of your own .cfg file, or wish to use a layout specifically for Amiberry, you can create a file for this purpose with a plain text editor.

The below example details the options which are read for this purpose, and the below example can be copied and modified as required.

# Keyboard input. Will recognize letters ("a" to "z") and the following special keys (where "kp_"
# is for keypad keys):
#
#   left, right, up, down, enter, kp_enter, tab, insert, del, end, home,
#   rshift, shift, ctrl, alt, space, escape, add, subtract, kp_plus, kp_minus,
#   f1, f2, f3, f4, f5, f6, f7, f8, f9, f10, f11, f12,
#   num0, num1, num2, num3, num4, num5, num6, num7, num8, num9, pageup, pagedown,
#   keypad0, keypad1, keypad2, keypad3, keypad4, keypad5, keypad6, keypad7, keypad8, keypad9,
#   period, capslock, numlock, backspace, multiply, divide, print_screen, scroll_lock,
#   tilde, backquote, pause, quote, comma, minus, slash, semicolon, equals, leftbracket,
#   backslash, rightbracket, kp_period, kp_equals, rctrl, ralt
#
# Keyboard input, Joypad and Joyaxis will all obey the "nul" bind, which disables the bind completely, 
# rather than relying on a default.
input_player1_a = "x"
input_player1_b = "z"
input_player1_y = "a"
input_player1_x = "s"
input_player1_start = "enter"
input_player1_select = "rshift"
input_player1_l = "q"
input_player1_r = "w"
input_player1_left = "left"
input_player1_right = "right"
input_player1_up = "up"
input_player1_down = "down"
# input_player1_l2 =
# input_player1_r2 =
# input_player1_l3 =
# input_player1_r3 =

Amiberry is currently limited to Keyboard remapping for a single input only. ('Player 1')

Setting the RetroArch keyboard input

From the Amiberry GUI you should navigate to the Paths panel. From here you will need to select the location where your retroarch.cfg file has been stored.

For RetroPie, you should select /opt/retropie/configs/all/retroarch/retroarch.cfg

Once selected, click the 'Rescan Paths' button shown at the bottom of the panel.