base on Linux kernel driver for Xbox One and Xbox Series X|S accessories <p align="center"> <img src="logo.svg" alt="Logo" width="200"> </p> <p align="center"> <a href="https://github.com/medusalix/xone/releases/latest"><img src="https://img.shields.io/github/v/release/medusalix/xone?logo=github" alt="Release Badge"></a> <a href="https://discord.gg/FDQxwWk"><img src="https://img.shields.io/discord/733964971842732042?label=discord&logo=discord" alt="Discord Badge"></a> <a href="https://www.paypal.com/donate?hosted_button_id=BWUECKFDNY446"><img src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_SM.gif" alt="Donate Button"></a> </p> `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). ## Compatibility - [x] Wired devices (via USB) - [x] Wireless devices (with Xbox Wireless Dongle) - [ ] Bluetooth devices (check out [`xpadneo`](https://github.com/atar-axis/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`](https://github.com/medusalix/xpad-noone) as a replacement for `xpad`. ## Important notes 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*](https://discord.gg/FDQxwWk).** ## Features - [x] Input and force feedback (rumble) - [x] Battery reporting (`UPower` integration) - [x] LED control (using `/sys/class/leds`) - [x] Audio capture/playback (through `ALSA`) - [x] Power management (suspend/resume and remote/wireless wakeup) ## Supported devices - [x] Gamepads - [x] Xbox One Controllers - [x] Xbox Series X|S Controllers - [x] Xbox Adaptive Controller - [x] Third party controllers (PowerA, PDP, etc.) - [x] Headsets - [x] Xbox One Chat Headset - [x] Xbox One Stereo Headset (adapter or jack) - [x] Xbox Wireless Headset - [x] Third party wireless headsets (SteelSeries, Razer, etc.) - [x] Guitars & Drums - [x] Mad Catz Rock Band 4 Wireless Fender Stratocaster - [x] Mad Catz Rock Band 4 Wireless Drum Kit - [x] PDP Rock Band 4 Wireless Fender Jaguar - [x] Xbox One Chatpad - [ ] Third party racing wheels (Thrustmaster, Logitech, etc.) ## Releases [](https://repology.org/project/xone/versions) 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 5.13+ and headers) - DKMS - curl (for firmware download) - cabextract (for firmware extraction) ### Guide 1. Unplug your Xbox devices. 2. Clone the repository: ``` git clone https://github.com/medusalix/xone ``` 3. Install `xone`: ``` cd xone sudo ./install.sh ``` **NOTE:** You can use the `--release` flag to disable debug logging. 4. Download the firmware for the wireless dongle: ``` sudo xone-get-firmware.sh ``` **NOTE:** The `--skip-disclaimer` flag might be useful for scripting purposes. 5. Plug in your Xbox devices. ### Updating Make sure to completely uninstall `xone` before updating: ``` sudo ./uninstall.sh ``` ## Wireless pairing 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](https://support.xbox.com/en-US/help/hardware-network/controller/connect-xbox-wireless-controller-to-pc) (see the section on *Xbox Wireless*). ## LED control 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. ## Troubleshooting 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. ### Error messages - `Direct firmware load for xow_dongle.bin failed with error -2` - Download the firmware for the wireless dongle (see installation guide). ### Input issues You can use `evtest` and `fftest` to check the input and force feedback functionality of your devices. ### Other problems Please join the [Discord server](https://discord.gg/FDQxwWk) in case of any other problems. ## License `xone` is released under the [GNU General Public License, Version 2](LICENSE). ``` 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. ``` ", Assign "at most 3 tags" to the expected json: {"id":"6415","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"