Skip to content
/ xone Public
forked from medusalix/xone

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

License

Notifications You must be signed in to change notification settings

lennie420/xone

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

54 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C 97.8%
  • Shell 1.8%
  • Makefile 0.4%