Xone Driver Manager - Decky Plugin

A Decky Loader plugin to install and manage the 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 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 for more information.

1. Download the .zip from the latest releases 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.

Starting with version 0.3.0, the plugin includes a built-in auto-update system. When a new release is detected, a button will appear allowing you to download and install the update seamlessly. The Quick Access Menu will briefly refresh to apply the changes.

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 installed
• Xbox One or Series controller (wired) or Xbox Wireless Adaptor for Windows (wireless)

Credits

• xone - Modern Linux kernel driver for Xbox One and Xbox Series X|S accessories
• xpad-noone - xpad replacement for legacy Xbox/Xbox 360 peripherals
• Original install script - My script this plugin is based on
• Decky Loader - The plugin framework

License

BSD-3-Clause License - See LICENSE for details.