/xone

Linux kernel driver for Xbox One and Xbox Series X|S accessories

Primary LanguageCGNU General Public License v2.0GPL-2.0

xone Release Badge Discord Badge Donate Button

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). If you are looking for a way to use your controller via Bluetooth, check out xpadneo. Take a look at this spreadsheet for a comparison between all the different Linux drivers.

Important notes

This driver is still in active development. Use at your own risk! Any feedback including bug reports, suggestions or ideas is greatly appreciated.

Features

  • Input and force feedback (rumble)
  • Battery reporting (UPower integration)
  • LED brightness control (using /sys/class/leds)
  • Audio capture/playback (through ALSA)
  • Power management (suspend/resume and remote wakeup)
  • Wireless connectivity (via dongle)

Supported devices

  • 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.)
  • Racing wheels
  • Xbox One Chatpad
  • Xbox Adaptive Controller
  • Mad Catz Rock Band 4 Wireless Stratocaster
  • Mad Catz Rock Band 4 Wireless Drum Kit

Releases

Packaging status

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.

Installation

Prerequisites

  • Linux (kernel 4.15+ and headers)
  • DKMS

Clone the repository:

git clone https://github.com/medusalix/xone

Install xone using the following command:

sudo ./install.sh --release

NOTE: Please omit the --release flag when asked for your debug logs.

Updating

Make sure to completely uninstall xone before updating:

sudo ./uninstall.sh

License

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.