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).
- Wired devices (via USB)
- Wireless devices (with Xbox Wireless Dongle)
- Bluetooth devices (check out
xpadneo
)
This driver is still in active development. Use at your own risk!
If you are running xow
upgrading to xone
is highly recommended!
Always update your Xbox devices to the latest firmware version!
Any feedback including bug reports, suggestions or ideas is greatly appreciated.
- Input and force feedback (rumble)
- Battery reporting (
UPower
integration) - LED control (using
/sys/class/leds
) - Audio capture/playback (through
ALSA
) - Power management (suspend/resume and remote/wireless wakeup)
- Gamepads
- Xbox One Controllers
- Xbox Series X|S Controllers
- Third party controllers (PowerA, PDP, etc.)
- Headsets
- Xbox One Chat Headset
- Xbox One Stereo Headset (adapter or jack)
- Xbox Wireless Headset
- Third party wireless headsets (SteelSeries, Razer, etc.)
- Third party racing wheels (Thrustmaster, Logitech, etc.)
- Xbox One Chatpad
- Xbox Adaptive Controller
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.
- Linux (kernel 4.15+ and headers)
- DKMS
- curl (for firmware download)
- cabextract (for firmware extraction)
-
Unplug your Xbox devices.
-
Clone the repository:
git clone https://github.com/medusalix/xone
- Install
xone
using the following command:
cd xone
sudo ./install.sh --release
NOTE: Please omit the --release
flag when asked for your debug logs.
- Download the firmware for the wireless dongle:
sudo xone-get-firmware.sh
NOTE: The --skip-disclaimer
flag might be useful for scripting purposes.
- Plug in your Xbox devices.
Make sure to completely uninstall xone
before updating:
sudo ./uninstall.sh
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
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.
The pairing mode of the dongle can be queried via sysfs
:
cat /sys/bus/usb/drivers/xone-dongle/*/pairing
You can enable (1
) or disable (0
) the pairing using the following command:
echo 1 | sudo tee /sys/bus/usb/drivers/xone-dongle/*/pairing
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
- Download the firmware for the wireless dongle (see installation guide).
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
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.