Skip to content

Releases

v1.2.1 – First release

Choose a tag to compare

@m2aadhil m2aadhil released this 04 Oct 00:05
6f270ab

Xbox Wireless Helper, a Decky Loader plugin that makes the Xbox Wireless Adapter behave on Bazzite, SteamOS, and other Linux gaming setups.

✨ Features

  • Fixes the controller after sleep. No more unplugging and replugging the adapter. After every wake, the plugin waits for USB to settle and resets the adapter in software. If the gentle reset fails, it escalates: re-authorize → USB port power-cycle → USB reset.
  • Wake the PC with the Xbox button. One toggle enables wake on the adapter, its hubs, the USB controller, and the matching firmware (ACPI) wake entries. It's re-applied after every reset and replug, and your original settings are restored when you turn it off or uninstall.
  • Pairing button. Put the adapter into pairing mode from the Quick Access menu, without reaching behind the PC.
  • Live status. The panel shows the adapter, connected controllers and how each is connected (adapter / Bluetooth / cable), wake status, and the last reset result.
  • Keep USB powered in sleep (last resort). Switches sleep to s2idle for boards that cut USB power in deep sleep. ⚠️ May keep the fans running.

Requirements: Decky Loader, and the xone driver for the adapter (default on Bazzite). Pairing and wake-from-sleep need xone.

⚠️ Known limitations

  • Bluetooth-connected controllers can't wake the PC on Linux. Use the adapter or a cable.
  • "Keep USB powered in sleep" (s2idle) keeps most desktop boards in their "on" power state, so the fans keep spinning.
  • BIOS options vary a lot between manufacturers. Please open an issue with your board model if wake doesn't work for you.

Tested on Bazzite with the Xbox Wireless Adapter for Windows.

What's Changed

  • Bump @types/react-dom from 19.1.1 to 19.3.0 by @dependabot[bot] in #7

Full Changelog: v1.0.0...v1.2.1