Input Mapping Guide

Input Mapping Guide

This guide consolidates controller and keyboard mapping workflows. For detailed pages, see Setting up Input Controllers and Setting up Keyboard Controllers.

Choose your mapping method

1) Native Amiberry mappings

Best if you want per‑game controls or quick edits from the GUI.

Steps:

1. Open the Input panel and select devices per port.
2. Use Custom Controls to bind actions and Custom Events for Amiga inputs.

2) RetroArch mappings

Best if you already have RetroArch controller .cfg files.

Steps:

1. Set the RetroArch .cfg path in Paths.
2. Re‑scan paths.
3. Configure HotKey functions in RetroArch Commands.

Keyboard as joystick

If using keyboard for joystick input:

• Select Keyboard as Joystick in the Input panel.
• Customize mappings in a RetroArch .cfg if needed (see Setting up Keyboard Controllers).

Mouse / joystick autoswitching

If you use mouse and joystick together, enable Mouse/Joystick autoswitching in the Input panel. See Mouse/Joystick Autoswitching for behavior details.

Common tips

• Use Rescan Paths after changing controller configs or moving files.
• Save a per‑game .uae config if you need unique mappings for a title.
• If mappings do not apply, confirm the correct device is selected per port.

Troubleshooting

If a controller isn’t detected or mappings don’t apply, see Troubleshooting.