Skip to content

Input settings

Tomáš Kelemen edited this page Feb 19, 2025 · 5 revisions

Joypad auto configuration

When you plug a joypad to your Lakka box, RetroArch will try to match its vid:pid pair or its name to one of the config files stored in /etc/retroarch-joypad-autoconfig. Those config files are maintained in this git repository.

When there is an configuration already available from this repository, you should see a yellow message with the name of your joypad appearing on the bottom part of the screen when Lakka starts and at certain other times during operation, depending on your Lakka settings.

If your joypad is already supported, it will work out of the box. Otherwise you will need to "map" or "bind" the buttons on the control to RetroArch and then create your own configuration file. This process takes approximately one minute for most joypads.

Pairing a Bluetooth gamepad

Put your gamepad to pairing mode and navigate to to Settings → Bluetooth. Lakka will search for nearby devices. Select the device you want to pair and confirm. After couple of seconds your gamepad should be paired and, if a configuration exists, autoconfigured.

If you later pair your gamepad with a different console/computer, you have to pair the gamepad with Lakka again. Before that you have to remove the previous pairing of that gamepad from Lakka. Navigate to Settings → Bluetooth, wait until devices are show, navigate to your gamepad and press Start button on your gamepad or Space key on your keyboard. Notification will pop-up that the pairing was removed. Restart RetroArch and pair your gamepad as described above.

Mapping

When configuring a joypad, keep in mind that RetroArch joypad abstraction is inspired by the SNES pad for the placement of the buttons ABXY:

RetroPad

Binding a joypad

If your joypad is not recognized by Lakka, you will need to bind the buttons.

  1. Go to the Input Settings using a keyboard and Bind all bottons on your joypad for the User #1.
  2. Optional: Generate an autoconfig file for your joypad and contribute it to our repository. Your joypad will then be supported automatically for all RetroArch platforms and users beginning with its next release.

Wireless joypads

These wireless joypads have been tested with Lakka:

The XBox360 wireless joypad and its microsoft adapter works out of the box on Lakka. You will get better results with an official adapter, but we do support some Chinese clones. This adapter does not use bluetooth but a proprietary infrared protocol.

The DualShock3 requires a bluetooth dongle or a computer with integrated bluetooth. Follow the Wireless DualShock instructions and be aware that auto-configuration is complicated by bluetooth's pairing system and will not the same as with wired joypads.

Input remapping

The recent version of RetroArch can remap inputs per core, or maybe even per game.

Clone this wiki locally