Linux kernel driver for Xbox One and Xbox Series X|S accessories
See the code
xone is a Linux kernel driver for Xbox One and Xbox Series X|S accessories. It serves as a modern replacement for xpad, aiming to be compatible with Microsoft's Game Input Protocol (GIP).
xpadneo)Installing xone will disable the xpad kernel driver. If you are still using Xbox or Xbox 360 peripherals, you will have to install xpad-noone as a replacement for xpad.
[!IMPORTANT] This project is in maintenance mode and will receive only occasional minor fixes. An actively developed fork is available here.
UPower integration)/sys/class/leds)ALSA)
Feel free to package xone for any Linux distribution or hardware you like.
Any issues regarding the packaging should be reported to the respective maintainers.
Unplug your Xbox devices.
Clone the repository:
git clone https://github.com/medusalix/xone
xone:cd xone
sudo ./install.sh
NOTE: You can use the --release flag to disable debug logging.
sudo xone-get-firmware.sh
NOTE: The --skip-disclaimer flag might be useful for scripting purposes.
Make sure to completely uninstall xone before updating:
sudo ./uninstall.sh
Xbox devices have to be paired to the wireless dongle. They will not automatically connect to the dongle if they have been previously plugged into a USB port or used via Bluetooth.
Instructions for pairing your devices can be found here (see the section on Xbox Wireless).
The guide button LED can be controlled via sysfs:
echo 2 | sudo tee /sys/class/leds/gip*/mode
echo 5 | sudo tee /sys/class/leds/gip*/brightness
Changing the LED in the above way is temporary, it will only last until the device disconnects. To apply these settings automatically when a device connects, you can create a new udev rule in /etc/udev/rules.d/50-xone.rules with the following content:
ACTION=="add", SUBSYSTEM=="leds", KERNEL=="gip*", ATTR{mode}="2", ATTR{brightness}="5"
Replace the wildcard (gip*) if you want to control the LED of a specific device.
The modes and the maximum brightness can vary from device to device.
Uninstall the release version and install a debug build of xone (see installation guide).
Run sudo dmesg to gather logs and check for any error messages related to xone.
If xone is not being loaded automatically you might have to reboot your system.
Direct firmware load for xow_dongle.bin failed with error -2
You can use evtest and fftest to check the input and force feedback functionality of your devices.
Please join the Discord server in case of any other problems.
xone is released under the GNU General Public License, Version 2.
Copyright (C) 2021 Severin von Wnuck-Lipinski
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
46 followers · starred Jul 2021
70 followers · starred Apr 2026
57 followers · starred Aug 2023
132 followers · starred May 2023
Linux kernel driver for Xbox One and Xbox Series X|S accessories
See the code
xone is a Linux kernel driver for Xbox One and Xbox Series X|S accessories. It serves as a modern replacement for xpad, aiming to be compatible with Microsoft's Game Input Protocol (GIP).
xpadneo)Installing xone will disable the xpad kernel driver. If you are still using Xbox or Xbox 360 peripherals, you will have to install xpad-noone as a replacement for xpad.
[!IMPORTANT] This project is in maintenance mode and will receive only occasional minor fixes. An actively developed fork is available here.
UPower integration)/sys/class/leds)ALSA)
Feel free to package xone for any Linux distribution or hardware you like.
Any issues regarding the packaging should be reported to the respective maintainers.
Unplug your Xbox devices.
Clone the repository:
git clone https://github.com/medusalix/xone
xone:cd xone
sudo ./install.sh
NOTE: You can use the --release flag to disable debug logging.
sudo xone-get-firmware.sh
NOTE: The --skip-disclaimer flag might be useful for scripting purposes.
Make sure to completely uninstall xone before updating:
sudo ./uninstall.sh
Xbox devices have to be paired to the wireless dongle. They will not automatically connect to the dongle if they have been previously plugged into a USB port or used via Bluetooth.
Instructions for pairing your devices can be found here (see the section on Xbox Wireless).
The guide button LED can be controlled via sysfs:
echo 2 | sudo tee /sys/class/leds/gip*/mode
echo 5 | sudo tee /sys/class/leds/gip*/brightness
Changing the LED in the above way is temporary, it will only last until the device disconnects. To apply these settings automatically when a device connects, you can create a new udev rule in /etc/udev/rules.d/50-xone.rules with the following content:
ACTION=="add", SUBSYSTEM=="leds", KERNEL=="gip*", ATTR{mode}="2", ATTR{brightness}="5"
Replace the wildcard (gip*) if you want to control the LED of a specific device.
The modes and the maximum brightness can vary from device to device.
Uninstall the release version and install a debug build of xone (see installation guide).
Run sudo dmesg to gather logs and check for any error messages related to xone.
If xone is not being loaded automatically you might have to reboot your system.
Direct firmware load for xow_dongle.bin failed with error -2
You can use evtest and fftest to check the input and force feedback functionality of your devices.
Please join the Discord server in case of any other problems.
xone is released under the GNU General Public License, Version 2.
Copyright (C) 2021 Severin von Wnuck-Lipinski
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
46 followers · starred Jul 2021
70 followers · starred Apr 2026
57 followers · starred Aug 2023
132 followers · starred May 2023