Repository navigation
OsmsPad: own virtual gamepad driver (UMDF + VHF) to replace ViGEmBus - #65
Merged
Merged
Conversation
A UMDF filter above Windows' Virtual HID Framework that creates Xbox Series controllers on demand through a private IOCTL interface. Windows attaches its inbox xinputhid filter, so games see them through XInput, GameInput and DirectInput, without ViGEmBus. Each controller belongs to the handle that created it and goes away when that handle closes, and its instance ID carries the Windows session it was created for (OSMS_S<session>_P<n>), so the service can isolate it without guessing. Rumble comes back to the client. Signed like RemoteIdd with a one-use test certificate; being user-mode only, it loads without test signing. Includes OsmsPadSetup (root device), package, install and uninstall scripts, a unit test of the report encoding and an end-to-end test that checks the controller through XInput. Adapted from ideas in libvirtualgamepad (MIT, see THIRD_PARTY_NOTICES.md). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
OsmsPad's root device is treated like a ViGEm bus: its children are the
controllers. Their instance ID ends in OSMS_S<session>_P<n>, so the session
comes straight from the driver instead of from Sunshine's log; the log only
gives the pad's number in that Sunshine ("OsmsPad controller P created for
gamepad N") for the mosaic. A controller from a Windows session with no
OpenStreamMS session (e.g. OsmsPadTest) is still confined to that session.
Sunshine is configured with gamepad_driver = osmspad when the driver is
installed; it falls back to ViGEmBus by itself if the driver goes missing.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
build-installer compiles and signs OsmsPad like RemoteIdd (one-use test certificate) into osmspad-pkg; setup installs it on Windows 10 2004 or later, before the service starts so Sunshine picks gamepad_driver = osmspad, and the uninstaller removes the device, the driver package and its certificate. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
# Conflicts: # Core/Installer/messages.generated.iss # Core/Installer/messages/bg.json # Core/Installer/messages/cs.json # Core/Installer/messages/de.json # Core/Installer/messages/en.json # Core/Installer/messages/en_GB.json # Core/Installer/messages/en_US.json # Core/Installer/messages/es.json # Core/Installer/messages/fr.json # Core/Installer/messages/hu.json # Core/Installer/messages/it.json # Core/Installer/messages/ja.json # Core/Installer/messages/ko.json # Core/Installer/messages/pl.json # Core/Installer/messages/pt.json # Core/Installer/messages/pt_BR.json # Core/Installer/messages/ru.json # Core/Installer/messages/sv.json # Core/Installer/messages/tr.json # Core/Installer/messages/uk.json # Core/Installer/messages/vi.json # Core/Installer/messages/zh.json # Core/Installer/messages/zh_TW.json
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.
Adds OsmsPad, a UMDF filter on top of VHF that creates Xbox Series controllers seen by XInput, with rumble back to the client. It loads without test signing (one-off test certificate, like RemoteIdd).
Native/OsmsPad: driver, package and install/uninstall scriptsOSMS_S<session>_P<n>) instead of guessing from the Sunshine loggamepad_driver = osmspadwhen the driver is installedNote: the bundled
sunshine.exedoesn't have the OsmsPad backend yet, so it ignores that setting and keeps using ViGEmBus. Controllers switch to OsmsPad once a Sunshine-Web-RTC build with the backend ships.Tested: build, unit and i18n tests; driver tested locally with OsmsPadTest (buttons, sticks, triggers, rumble, removal).
🤖 Generated with Claude Code