Skip to content

Controller Configuration

RetroPie supports many popular controllers out of the box. On first boot you will be prompted to configure a controller in EmulationStation. Once you finish configuring your controller, multiple configuration profiles will be automagically generated for most of the systems in RetroPie.

Some emulators will still require manual controller configuration which will be detailed on their respective system page here in the documentation.

You can also configure controls for individual systems and individual games. For more advanced controller configuration with libretro cores (any emulator that starts with lr) see the RetroArch-Configuration page.

Note that some controllers (primarily wireless or bluetooth controllers) may require special drivers to be installed through the RetroPie Setup Script which are detailed on their individual controller page.

Controller Configuration

On first boot this menu in EmulationStation will configure your controls for both Emulationstation and RetroArch Emulators:

welcomescreen

Hold down any button on your keyboard or gamepad and the name will appear at the bottom and then open up into a configuration menu:

welcomescreengamepadname

Follow the onscreen instructions to configure your gamepad- if you run out of buttons just hold down a button to skip each unused button. When you get to OK press the button you have configured as "A".

welcomescreengamepadconfigure

If you wish to configure more than one controller, you can do so from the start menu of emulationstation. For more details on manual controller configurations see this page Here.

See the following diagrams for reference:

SNES Controller
snes_controller
XBox 360 Controller
xbox360_controller
PS3 Controller
ps3_controller

Hotkey

The Hotkey button enables you to press it in combination with another button to access functions such as saving, loading, and exiting in emulators. It is suggested to use the Select button as the hotkey. The following chart shows the default hotkey combinations. For example, if you chose Select as your Hotkey, that means you hold down Select while pressing the other button to execute the command.

Note Hotkey combinations are specific to the retroarch/libretro based emulators.

Hotkey Combination Action
Hotkey+Start Exit
Hotkey+Right Shoulder Save
Hotkey+Left Shoulder Load
Hotkey+Right Input State Slot Increase
Hotkey+Left Input State Slot Decrease
Hotkey+X RGUI Menu
Hotkey+B Reset

For more information, see Hotkeys