https://github.com/savagecore/xone-decky-plugin
https://github.com/savagecore/xone-decky-plugin
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/savagecore/xone-decky-plugin
- Owner: SavageCore
- License: other
- Created: 2026-01-26T03:53:07.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-01-27T02:34:09.000Z (4 months ago)
- Last Synced: 2026-01-27T03:19:14.090Z (4 months ago)
- Language: Shell
- Size: 1.05 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Xone Driver Manager - Decky Plugin
A [Decky Loader](https://github.com/SteamDeckHomebrew/decky-loader) plugin to install and manage the [xone](https://github.com/dlundqvist/xone) Linux kernel driver for Xbox One and Xbox Series X|S accessories.
xone is a modern replacement for xpad, aiming to be compatible with Microsoft's Game Input Protocol (GIP). Installing xone will disable the xpad kernel driver. If you still use Xbox or Xbox 360 peripherals, this plugin also installs [xpad-noone](https://github.com/forkymcforkface/xpad-noone) as a replacement for xpad.
## Features
- **One-click driver installation** - Install the xone and xpad-noone drivers directly from Gaming Mode
- **Easy uninstallation** - Remove drivers cleanly with a single click
- **Pairing mode control** - Enable/disable dongle pairing mode without leaving Gaming Mode
- **SteamOS update detection** - Automatically notifies you when drivers need reinstalling after a system update
## Screenshots
| Not Installed | Installing | Installed | Pairing |
| :----------------------------------------: | :----------------------------------: | :--------------------------------: | :----------------------------: |
|  |  |  |  |
## Installation
> [!NOTE]
> The Decky store does not accept plugins that disable read-only so you must install manually. See [the PR](https://github.com/SteamDeckHomebrew/decky-plugin-database/pull/968#pullrequestreview-3730477839) for more information.
1. Download the `.zip` from the latest [releases](https://github.com/SavageCore/xone-decky-plugin/releases/latest) page.
2. Open the Decky settings and navigate to **Developer**.
3. Click **Install Plugin from ZIP File**.
4. Select the downloaded `.zip` file.
### Updates
Since this plugin is not on the Decky Store, you won't get automatic updates through the store/Decky Loader.
However, as of version 0.2.0, the plugin will show you when a new version is available and provide a button to download it. You can then follow the manual installation steps to update.
### Building from Source
1. Clone the repository
2. Run `pnpm install` to install dependencies
3. Run `pnpm run package` to build and package the plugin
4. Transfer the `.zip` file in the `out/` directory to your Steam Deck
5. Follow the manual installation steps above
## Usage
1. Open Quick Access Menu (⋯ button)
2. Navigate to the Decky tab (plug icon)
3. Click on "Xone Driver Manager"
4. Click **Install Drivers** to install the drivers
### Pairing a Controller to the Dongle
1. Click the toggle to enable pairing mode (dongle LED will blink)
2. Hold the pairing button on your Xbox controller until the Xbox logo blinks rapidly
3. The controller will connect automatically
4. Disable pairing mode after successful connection
## After SteamOS Updates
When SteamOS updates, kernel modules are often removed. The plugin will detect this and show a notification prompting you to reboot and reinstall the drivers. Click **Reinstall Drivers** to restore functionality once you have rebooted.
## Requirements
- [Decky Loader](https://github.com/SteamDeckHomebrew/decky-loader) installed
- Xbox One or Series controller (wired) or Xbox Wireless Adaptor for Windows (wireless)
## Credits
- [xone](https://github.com/dlundqvist/xone) - Modern Linux kernel driver for Xbox One and Xbox Series X|S accessories
- [xpad-noone](https://github.com/forkymcforkface/xpad-noone) - xpad replacement for legacy Xbox/Xbox 360 peripherals
- [Original install script](https://github.com/SavageCore/xone-steam-deck-installer) - My script this plugin is based on
- [Decky Loader](https://github.com/SteamDeckHomebrew/decky-loader) - The plugin framework
## License
BSD-3-Clause License - See [LICENSE](LICENSE) for details.