Connect An Xbox One Controller

RetroPie supports the Xbox One Controller through a wired connection or through Bluetooth. In order to connect with Bluetooth, both your Raspberry Pi and Xbox One controller must support it.


Need Your Own Xbox One Controller?


Xbox One Controller - Minecraft


Wired Setup

Play with your Xbox One Controller with a wired connection




Step 1: Plug in your Xbox Controller

Plug in your Xbox One Controller using a micro USB cable from the controller to the USB ports of the Raspberry Pi.

Using a controller that already works such as a keyboard, hit the 'Start' button to bring up the menu then select to 'Configure Input'.



Step 2: Setup your buttons

Hold down any button on the Xbox One controller and set up your buttons as you see fit.

Remember, you can hold down any button to skip an input. If you make a mistake, just finish inputting all the buttons and reach the bottom. Once you are at the bottom, you can go back up to make any corrections.



Step 3: Play games!

When you get to the bottom select 'OK'. Sometimes it will freeze for a few seconds after you've hit the button, so just be a little patient.

Start up any game you'd like and give it a try. Your Xbox One Controller wired setup is complete.

Bluetooth Wireless Setup

The Bluetooth wireless setup is a bit more complicated, but this guide will get you through it!




Update your Controller

First, your Xbox One Controller may need an update if you haven't done so in awhile. Go to the link below to find out how.




Does my Xbox Controller have Bluetooth?

We can determine whether or not your Xbox One Controller has Bluetooth with the following diagram. Note the difference in design of the controllers where the Xbox button is


Why are there so many steps?

RetroPie has a few bugs regarding the Xbox One Controller connected through Bluetooth. There are proper fixes but they have not been included in the RetroPie package. Therefore, this guide includes these fixes to have a smooth experience with the Bluetooth pairing.

Setup RetroPie Manager

We'll need RetroPie Manager to help with our Bluetooth setup




Step 1: Access Raspberry Pi Configuration

Turn on your RetroPie, select the RetroPie system icon and select RetroPie Setup.




Step 2: Access Packages

Once the screen is availabe again, select 'Manage Packages' and OK.




Step 3: Access Experimental Packages

Now select 'Manage Experimental Packages' and OK.



Step 4: Install RetroPie Manager

Scroll down to near the bottom of the list and select the 'RetroPie Manager' and hit OK to begin the installation.



Step 5: RetroPie Manager Configuration

After the package has installed, select the 'Configuration/Options' so we can enable this new package.


Step 6: RetroPie Manager Configuration

Select the option to 'Start RetroPie Manager Now'. If you'd like, you can also select 'Start RetroPie Manager on Boot'. This just starts this service everytime you start your RetroPie.

You can now select 'Back' until you've returned to RetroPie's regular settings.



Step 7: Obtain RetroPie IP Address

Ensure that your RetroPie is connected to your network through WiFi or wired connections. Then select 'Show IP' on the RetroPie Settings.



Step 8: Note Your IP Address

Take note of your IP address shown on screen. It should be in the form of '192.168.XXX.XXX'. The numbers will vary person to person.


Step 9: Check Out the RetroPie Manager

Now on your computer, open a web browser and type in the IP address into the address bar and ending it with ':8000'. The final address should look something like '192.168.0.95:8000'.


Step 10: Go to our script file

From the dashboard of our RetroPie Manager, click the 'Read and edit the autostart.sh Script file'.


Step 11: Update our startup script

Copy and paste the following into our script like how it is in the screenshot.

sudo bash -c 'echo 1 > /sys/module/bluetooth/parameters/disable_ertm'

Then hit 'Save' at the bottom.

Bring On The Updates




Step 12: Raspberry Setup Menu

Go to the RetroPie options screen and select 'RetroPie Setup'.



Step 13: Update Packages

Scroll down to the option that says 'Update'. It may also say 'Update all installed packages' depending on what version you have.



Step 14: Update!

Select 'Yes' to update all the installed packages.



Step 15: No, again!

Continue through the messages by hitting 'OK' as they come until you hit the next Yes/No message regarding updating underlying OS packages. You can select 'No' for this.

It's fine if you hit 'Yes' as well. Hitting 'No' just speeds up the process.



Step 16: Waiting around

At this point, you can allow RetroPie to do its thing and update all the installed packages. When it is complete, it'll take you back to the initial 'RetroPie Setup' menu.

Select to 'Perform Reboot' and select 'Yes'.

Connect To Bluetooth

Let's finally connect!




Step 17: Bluetooth

Head to the RetroPie menu screen again and select the 'Bluetooth' option.




Step 18: Register Xbox One Controller

When the new menu has appeared, selecting the first option to register and connect a bluetooth device.




Step 19: Register Xbox One Controller

When the new menu has appeared, selecting the first option to register and connect a bluetooth device.




Step 20: Searching for devices

You will see a 'Searching' title on the screen and at this time, turn on your Xbox One Controller with the middle Xbox button and hold down the sync button at the top for a few seconds.

When the Xbox light is blinking quickly, it means it is attempting to connect.




Step 21: Connect to your device

Look for the 'Xbox Wireless Controller' in the list and select it to connect.




Step 22: Try a security mode

On the next screen, you'll be asked to select a security mode. Just try the first option. The screen will freeze for a few seconds as it tries to pair so be patient once again.

If the pairing fails, just try again as sometimes it doesn't work the first time around.




Step 23: Success!

When the pairing is complete, you should see a success message and you can head back out to the RetroPie menu.

Configure Those Buttons

The final stretch!




Step 24: Configure input

Select the 'Start' button again with your alternate working controller such as a keyboard and select to 'Configure Input'.

Start configuring the buttons as you'd like and read the tips below to help you out.




Tip 1: Trigger Buttons

When you encounter the left trigger button, you may notice it pauses for a second and skips the right trigger. When it does this, continue on and come back to it once you've reached the end.




Tip 2: Trigger Buttons Remap

When you reach the end and come back to remap the trigger buttons, ensure the trigger buttons are assigned like the screenshot. Sometimes the trigger buttons will be assigned as different values randomly.



Step 25: Play games!

When you get to the bottom select 'OK'. Sometimes it will freeze for a few seconds after you've hit the button, so just be a little patient.

Start up any game you'd like and give it a try. Your Xbox One Controller Bluetooth setup is complete.

Let your friends know if the guide helped you out!

Thanks for your feedback!

Give Us Feedback

Thanks for the feedback!

000webhost logo