Skip to content

Add DualSense Doctor - #1198

Open
MSPortnov wants to merge 1 commit into
SteamDeckHomebrew:mainfrom
MSPortnov:add-dualsense-doctor
Open

MSPortnov wants to merge 1 commit into
SteamDeckHomebrew:mainfrom
MSPortnov:add-dualsense-doctor

Conversation

@MSPortnov

@MSPortnov MSPortnov commented Nov 18, 2026 •

Copy link
Copy Markdown

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 or PROTON_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 root is required: Doctor writes to /sys to 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, runs btmon for an optional HCI trace and reads the kernel and BlueZ logs with journalctl. Lab alone would not need root.

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

  • I am the original author or an authorized maintainer of this plugin.
  • I have abided by the licenses of the libraries I am utilizing, including attaching license notices where appropriate.
  • Generative AI was NOT used to write a majority of the code I am submitting.

Plugin

  • I have verified that my plugin works properly on the Stable and Beta update channels of SteamOS. (Verified on Stable 3.9.5 only so far.)
  • I have verified my plugin is unique or provides more/alternative functionality to a plugin already on the store.

Backend

  • No: I am using a custom backend other than Python.
  • No: I am using a tool or software from a 3rd party FOSS project that does not have its dependencies statically linked. (Only standard SteamOS tools are called when present and nothing is bundled: bluetoothctl, btmon, dbus-monitor, journalctl, busctl, hciconfig, lsusb.)
  • No: I am using a custom binary that has all of its dependencies statically linked.

Community

  • I have tested and left feedback on two other pull requests for new or updating plugins.
  • I have commented links to my testing report in this PR.

Testing

  • Tested by a third party on SteamOS Stable or Beta update channel.

@MSPortnov
MSPortnov requested a review from a team as a code owner November 18, 2026 09:50
@github-actions github-actions Bot added the plugin-addition Adding a plugin to the Plugin Store label Nov 18, 2026
@github-actions

Copy link
Copy Markdown

Issues Found

No issues with your PR description were found.

Next Steps

  1. If we found any issues above, please edit your pull request description to resolve them and leave a comment saying you've done so.
  2. For the quickest review, please see the Community section of the pull request template for how you can help other developers.
  3. Once your description is correct, a maintainer will review your pull request as soon as possible.

Thank you for your contribution! If you need any help, please reach out on our Discord server. ❤️

This branch is waiting to be deployed

1 waiting deployment
testing_env — 1c3a50c1 Waiting Nov 18, 2026 by MSPortnov via Build plugin (DualSenseDoctor, true) #4253
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

plugin-addition Adding a plugin to the Plugin Store

Projects

Status: Ready for review

Development

Successfully merging this pull request may close these issues.

1 participant