Confused on Steam Play and Proton? Be sure to check out our guide.
We do often include affiliate links to earn us some pennies. See more here.

xpadneo [GitHub] seems like an interesting project for those of you who own the Xbox One S wireless gamepad, allowing you to connect it Bluetooth with other fun features.

Quite a new project this one, something I hadn't actually heard of before so it's likely new to a fair few of our readers as well. Hopefully some of you might find this interesting or useful.

According to the GitHub page it has these features:

  • Supports Bluetooth
  • Supports Force Feedback over Bluetooth
  • Supports Trigger Force Feedback
  • Offers a consistent mapping, even if paired to Windows before
  • Working Select, Start, Mode buttons
  • Support for Battery Level Indication (including Play `n Charge Kit)
  • Agile Development

Doesn't seem like there's any packages for it yet, not even in the Arch AUR, so you will need to install it yourself from their instructions.

Hat tip to Ale Funguju on Twitter.

Article taken from GamingOnLinux.com.
9 Likes
About the author -
author picture
I am the owner of GamingOnLinux. After discovering Linux back in the days of Mandrake in 2003, I constantly came back to check on the progress of Linux until Ubuntu appeared on the scene and it helped me to really love it. You can reach me easily by emailing GamingOnLinux directly.
See more from me
The comments on this article are closed.
9 comments

spiffyk May 30, 2018
It's worth noting that there's an install.sh script that installs the driver for you using DKMS, so "compiling it yourself" is a matter of executing it.

Edit: missed the special corrections form


Last edited by spiffyk on 30 May 2018 at 2:34 pm UTC
Liam Dawe May 30, 2018
Quoting: chancho_zombieDoes anyone know a simple gui that can reassign buttons on Xbox controller (wired)? Apparently it can't be done with SDL gamepad gui tool.
Possibly SC Controller? https://github.com/kozec/sc-controller
TurtleShark May 30, 2018
Quoting: GuestI was hoping one day I would be able to use my normal wireless xbox one controller with its official wireless receiver on Linux but it looks like that may never happen :(

Ikr man? There's been some work done on it, but it is all weird and encrypted. The dongle is actually just a normal wireless receiver...

For anyone who does have a bluetooth version and wants to use it without any drivers or troubleshooting, 8bitdo (the SNES controller guys) sell a wireless USB adapter that connects to a whole host of controllers and is just recognized as a xinput device. Been using it with both their SNES controller and my xbox one controller (bluetooth compatable) on my Debian machine without issues!


EDIT: I NEGLECTED to say that the 8bitdo REQUIRES a firmware update. I used windows to do this. There is supposed to be a linux tool (https://www.omgubuntu.co.uk/2016/08/update-8bitdo-firmware-linux), but I am unfamiliar with it!


Last edited by TurtleShark on 21 June 2018 at 4:45 pm UTC
M@GOid May 30, 2018
Quoting: GuestI was hoping one day I would be able to use my normal wireless xbox one controller with its official wireless receiver on Linux but it looks like that may never happen :(

I given up mine, with the USB adapter, for a niece to play Cuphead on Windows. The guys working on the driver do not seen much motivated to work on it, after all these years.

I Will buy the Bluetooth version for my gamepad collection when I find one at a good price. For now my needs are satisfied with a Steam Controller and a Dual Shock 4.


Last edited by M@GOid on 30 May 2018 at 6:41 pm UTC
M@GOid May 30, 2018
Quoting: GuestYa I was thinking of just getting a bluetooth adapter, though atm I'm just using a logitech f310 (bought specifically for linux) and was thinking of picking up what's basically the wireless version of that controller

Does Dual Shock 4 work out of the box? One thing I do like about the f310 is the xinput/dinput switch on the back which comes in handy for some games

I have a Logitech F710 and, for the point of view of plug and play and game compatibility, is very good. But I hate its analog triggers (small, too far and heavy springs) and it's a noisy gamepad. I didn't like its ergonomics at all, although it has one of the best face buttons out there. But if you like your F310, who knows... Its micro USB receptor is exclusive, do not work with mouse/keyboard ones and vice/versa. Has to be on line of sight or will have problems. Also, no micro-USB connector on the gamepad means you're screwed when batteries die during a game. Nor I nor any of my friends like it. In fact, a friend bought it and gave it to me because he hate it. I have it just for kicks.

The Dual Shock 4 will work out of the box on a 2018 distro such as Ubuntu. Game compatibility is also very good. Only a couple games will not recognize it (indie games). Is a very ergonomic controller (way more than a Logitech) and the only real problem with it, is the button layout can make you confused on games that recognize it (such as Shadow of Mordor), when the game tells you to press square or triangle and you have to look down at the gamepad to find it. As a Xbox layout guy, took me a week to memorize. If you go buy a Bluetooth dongle for it, get at last a 4.0 specification. Earlier ones ask you to type PINs while pairing it, do not worth the pennies saved.

The Xbox One Controller works out of the box on Linux with a simple micro-USB cable, but is by far the most problematic in the game compatibility arena, especially the "One S" with bluetooth, where several games do not recognize it, mostly indie games. Last time I tried a "One S" unit, there was a problem with button mapping, that this xpadneo driver proposes to resolve. Again, buy a Bluetooth 4 dongle for better results.

TL;DR
Test your Xbox One Controller with a micro-USB cable, works fine on Linux. Don't buy the Logitech F710. Dualshock 4 is a nice option. Xbox One S have problems.
ProfessorKaos64 May 31, 2018
I don't mind making an AUR apckage for it.
Usual May 31, 2018
Battery level Indication? Sounds like a neat feature. Any other controllers do that, and where can I find it? On the Mate DE btw.
TurtleShark Jun 21, 2018
Quoting: GuestSo the wire on my logitech gt340 has stopped working altogether, so I need to order a new controller ASAP

Turns out my xbox one controller isn't the bluetooth model so if I was to go with the Xbox One controller I'd have to buy a new one

The only thing that concerns me is what M@GOid said, about Xbox One controllers being the worse in terms of game compatibility, that's an issue for me as I'd want the controller to work in *all* my linux games that have controller support


TurtleShark mentions an 8bitdo wireless bluetooth adapter, that recognizes the controllers are an xinput device, does this mean it would have the same compatibility as all other xinput controllers, like the xbox 360 controller (and my logitech f310) ??


This is what I found when looking for this adapter

https://www.amazon.co.uk/8Bitdo-Wireless-Bluetooth-Raspberry-Nintendo/dp/B0786JC6VW/ref=sr_1_1?ie=UTF8&qid=1529588559&sr=8-1&keywords=8bitdo+bluetooth+adapter

But if you scroll down to "customer question and answers" one person asks if Xbox One Controllers are supported and someone answered saying no

I'm so confused as to what to do, but I want to order a new controller ASAP because right now I'm without ANY game controller to use on Linux and I do 90% of my gaming with a controller

That is weird!! That Amazon comment is from March 12th, but they released that firmware update March 14th! They really should have updated that on Amazon. If you check their site out firmware v1.16 DOES include support for the XboxOne S (the bluetooth variant).

You will have to figure out how to update the firmware...there is supposed to be a way to do it on Linux using fuwp (https://www.omgubuntu.co.uk/2016/08/update-8bitdo-firmware-linux), but I just used my Windows partition to update the firmware (others said they've used a Widnows VM for the controllers).

TL : DR
It does work.
Must be XboxOne S controller
Must find out how to update firmware
TurtleShark Jun 21, 2018
Quoting: Guest
Quoting: TurtleShark
Quoting: GuestSo the wire on my logitech gt340 has stopped working altogether, so I need to order a new controller ASAP

Turns out my xbox one controller isn't the bluetooth model so if I was to go with the Xbox One controller I'd have to buy a new one

The only thing that concerns me is what M@GOid said, about Xbox One controllers being the worse in terms of game compatibility, that's an issue for me as I'd want the controller to work in *all* my linux games that have controller support


TurtleShark mentions an 8bitdo wireless bluetooth adapter, that recognizes the controllers are an xinput device, does this mean it would have the same compatibility as all other xinput controllers, like the xbox 360 controller (and my logitech f310) ??


This is what I found when looking for this adapter

https://www.amazon.co.uk/8Bitdo-Wireless-Bluetooth-Raspberry-Nintendo/dp/B0786JC6VW/ref=sr_1_1?ie=UTF8&qid=1529588559&sr=8-1&keywords=8bitdo+bluetooth+adapter

But if you scroll down to "customer question and answers" one person asks if Xbox One Controllers are supported and someone answered saying no

I'm so confused as to what to do, but I want to order a new controller ASAP because right now I'm without ANY game controller to use on Linux and I do 90% of my gaming with a controller

That is weird!! That Amazon comment is from March 12th, but they released that firmware update March 14th! They really should have updated that on Amazon. If you check their site out firmware v1.16 DOES include support for the XboxOne S (the bluetooth variant).

You will have to figure out how to update the firmware...there is supposed to be a way to do it on Linux using fuwp (https://www.omgubuntu.co.uk/2016/08/update-8bitdo-firmware-linux), but I just used my Windows partition to update the firmware (others said they've used a Widnows VM for the controllers).

TL : DR
It does work.
Must be XboxOne S controller
Must find out how to update firmware

I did check their site, I've put the order in now anyway along with a new controller, wasn't cheap!

Anyways that's the other thing I was going to ask, I checked their site and noticed the firmware updates are only for windows

I do dual boot however, are you saying I would be able to install the firmware updates on my Windows install and that would also update it when I use my Linux install also? They're both on seperate hard drives by the way, W10 on one hdd and Linux Mint on the other


Yes! The firmware lives on the USB receiver itself, so its a one-time thing and you can plug it into any computer after and it'll work. Their firmware-update-tool on the website only runs on windows. (Unless you want to try the Linux tool I linked to above).
While you're here, please consider supporting GamingOnLinux on:

Reward Tiers: Patreon. Plain Donations: PayPal.

This ensures all of our main content remains totally free for everyone! Patreon supporters can also remove all adverts and sponsors! Supporting us helps bring good, fresh content. Without your continued support, we simply could not continue!

You can find even more ways to support us on this dedicated page any time. If you already are, thank you!
The comments on this article are closed.