GUI Custom

Custom Controls Panel

This panel lets you remap controller buttons and axes to Amiga input events for a specific joystick port. Use it to customize button assignments beyond the defaults, or to set up hotkey-activated secondary mappings.

Joystick Port

Selects which Amiga joystick port's device to configure:

• 0: Mouse: Port 0, typically used for the mouse
• 1: Joystick: Port 1, typically used for the joystick
• 2: Parallel 1: First parallel port joystick adapter port
• 3: Parallel 2: Second parallel port joystick adapter port

If no valid joystick device is assigned to the selected port, the panel displays a message and no mapping controls are shown.

Function Key / Hotkey

Function Key

• Selects which mapping layer is displayed and edited in the remap table below
• None: Shows the base button mappings (active when no hotkey is held)
• HotKey: Shows the secondary button mappings (active when the hotkey button is held)

Set Hotkey

• Displays the currently assigned hotkey button name. Click the ... button to open a dialog and press a controller button to assign it as the hotkey. Click X to clear the hotkey assignment. Disabled for RetroArch-mapped controllers

Input Device

• Read-only field showing the name of the controller assigned to the selected port. Displays [R] for RetroArch-mapped controllers and [N] for native SDL controllers

Button and Axis Remapping

The scrollable area shows all available buttons and axes for the connected controller, split into two columns. Each row shows the button or axis name on the left and a dropdown on the right to assign an Amiga input event.

• Buttons or axes not physically present on the controller are shown as disabled
• Buttons already assigned to a special function (Hotkey, Quit, Menu, Reset, or VKBD) are shown as "In-Use (type)" and cannot be remapped
• Select None from the dropdown to clear a mapping
• The available events include all standard Amiga joystick and keyboard inputs, emulator functions (quit, reset, save state, etc.), and virtual keyboard toggle

Save as default mapping

• Saves the current button and axis mappings as the default for this controller. The mapping is written to a .controller file in the Controllers directory, named after the device. Disabled for RetroArch-mapped controllers