If you want to support me or accelerate the development of a special feature, consider a small donation
Just leave a message if your donation is for a specific use (like a new hardware or a specific function).
Advanced Linux Driver for Xbox One Wireless Gamepad
This is the first and yet only driver for the Xbox One Wireless Gamepad (which is shipped with the Xbox One S). I wrote it for a student project at fortiss GmbH and it is fully functional but does only support the connection via Bluetooth as yet - more will follow.
Many thanks to Kai Krakow who sponsored me a Xbox One Wireless Controller
Advantages of this driver
- Supports Bluetooth
- Supports Force Feedback (Rumble) in General
- Supports Trigger Force Feedback (not even supported in Windows)
see it in action: run
misc/tools/directional_rumble_test/direction_rumble_test <event# in /dev/input>
- Supports disabling FF
- Supports multiple Gamepads at the same time (not even supported in Windows)
- Offers a consistent mapping, even if the Gamepad was paired to Windows/Xbox before
- Working Select, Start, Mode buttons
- Correct Axis Range (signed, important for e.g. RPCS3)
- Supports Battery Level Indication (including the Play `n Charge Kit)
- Supports faking the Input Device Version in order to prevent SDL from trying to fix an unbroken mapping.
- Easy Installation
- Agile Support and Development
Make sure you have installed dkms, linux headers and a bluetooth implementation (e.g. bluez) and their dependencies.
- On Arch and Arch-based distros (like Antergos), try
sudo pacman -S dkms linux-headers bluez bluez-utils
- On Debian based systems (like Ubuntu) you can install those packages by running
sudo apt-get install dkms linux-headers-`uname -r`
- On Fedora, it is
sudo dnf install dkms bluez bluez-tools kernel-devel-`uname -r` kernel-headers-`uname -r`
- On OSMC you will have to run the following commands
sudo apt-get install dkms rbp2-headers-`uname -r`
sudo ln -s "/usr/src/rbp2-headers-`uname -r`" "/lib/modules/`uname -r`/build"(as a workaround)
- On Raspbian, it is
sudo apt-get install dkms raspberrypi-kernel-headers
If you recently updated your firmware using
rpi-updatethe above package may not yet include the header files for your kernel. Please follow the steps described here in this case.
Please feel free to add other Distributions as well!
- Download the Repository to your local machine
git clone https://github.com/atar-axis/xpadneo.git
[bluetooth]# scan on
- wait until all available devices are listed (otherwise it may be hard to identify which one is the gamepad)
- push the connect button on upper side of the gamepad, and hold it down until the light starts flashing fast
- wait for the gamepad to show up in bluetoothctl, remember the address (e.g.
[bluetooth]# pair <MAC>
[bluetooth]# trust <MAC>
[bluetooth]# connect <MAC>
You know that everything works fine when you feel the gamepad rumble ;)
sudo ./configure.shto configure the driver as you wish. The script will guide you through the available options.
In order to update xpadneo, do the following
- Update your cloned repo:
sudo ./uninstall.shto remove all installed versions of hid-xpadneo
For further information please visit the GitHub Page https://atar-axis.github.io/xpadneo/ which is generated automatically from the content of the
You will find there e.g. the following sections