Repository navigation
Add DualSense Doctor - #1198
Open
MSPortnov wants to merge 1 commit into
Open
Add DualSense Doctor#1198MSPortnov wants to merge 1 commit into
MSPortnov wants to merge 1 commit into
Conversation
Issues FoundNo issues with your PR description were found. Next Steps
Thank you for your contribution! If you need any help, please reach out on our Discord server. ❤️ |
MSPortnov
requested a deployment
to
testing_env
November 18, 2026 09:52 — with
GitHub Actions
Waiting
This branch is waiting to be deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Add DualSense Doctor to Plugin Store
DualSense Doctor: a plugin for the DualSense controller on SteamOS, in two parts.
Lab sets launch options per game (Proton version,
PROTON_*variables, Steam Input on/off) from a cover-art grid, for example DualShock 4 emulation orPROTON_DISABLE_HIDRAW=1.Doctor fixes the Bluetooth connection after sleep when the controller wakes the PC: the kernel drops the controller's first packet on resume, the link then gets closed at about 4 s or 28 s, and Steam may open the controller the wrong way (default lightbar color, A and B swapped). The plugin reconnects early, answers the lost L2CAP request, and delays Steam's pickup of the controller by about 5 seconds.
Repo: https://github.com/MSPortnov/DualSenseDoctor (version 0.8.13)
Similar plugins: Wake on Controller wakes the Deck from sleep with a controller's home button, and Xbox Wireless Helper repairs the Xbox Wireless Adapter after sleep. DualSense Doctor solves a different problem: it repairs the Bluetooth connection of a DualSense that has already woken the PC, and additionally sets per-game launch options for it. I am not aware of a store plugin that does either of these two things for the DualSense.
Why
rootis required: Doctor writes to/systo detach and re-attach the HID driver (unbind/bind) and to turn off USB autosuspend of the Bluetooth adapter, opens a raw HCI socket to send the L2CAP response, runsbtmonfor an optional HCI trace and reads the kernel and BlueZ logs withjournalctl. Lab alone would not needroot.Network access: the backend makes no network connections and sends nothing anywhere. The Bluetooth report is saved locally in the user's home folder. The frontend loads game cover art from Steam's local cache and, if it is missing, from Steam's CDN (the same covers Steam itself shows). No new dependencies; the backend uses the Python standard library only.
Testing notes: tested by the author on SteamOS 3.9.5 (Stable) on a desktop PC with a DualSense Edge over Bluetooth. Other controllers and hardware may behave differently. The plugin has a "Collect Bluetooth report" button, and the README explains how to report a problem.
Authorship: DualSense Doctor was developed with the help of an AI assistant (Claude). It is human-directed and tested on real hardware, so the "Generative AI was NOT used" box below is deliberately left unchecked.
Licenses: DualSense Doctor is GPL-3.0. Third-party components and icon credits (Font Awesome Free, react-icons, Decky libraries) are listed in
THIRD_PARTY_NOTICES.md.Task Checklist
Developer
Plugin
Backend
bluetoothctl,btmon,dbus-monitor,journalctl,busctl,hciconfig,lsusb.)Community
Testing