Skip to content

Razer: name the Windows-reinstalled legacy HID driver in the error - #270

Merged
snekxs merged 1 commit into
mainfrom
fix/razer-windows-driver-hint
Sep 12, 2026
Merged

snekxs merged 1 commit into
mainfrom
fix/razer-windows-driver-hint

Conversation

@snekxs

@snekxs snekxs commented Sep 12, 2026

Copy link
Copy Markdown
Member

Follow-up to #258. Issue #253/#166's symptom (zero Razer vendor collections granted, no Synapse running) is a Windows Update-reinstalled legacy Razer HID driver claiming the control interface exclusively, not something the app's shape/probe logic can recover from. This surfaces that specific cause and the actual fix (pnputil driver-store removal, not just Device Manager uninstall) instead of the generic error.

Claude-Session: https://claude.ai/code/session_01XbYSu8D3cu3c7vbEyJbacn

…be failure

Issue #253 and #166's pattern (Chrome grants only boot-mouse/consumer-control
leftovers, zero Razer vendor collections, no Synapse process running) matches
Windows Update pushing back an old 'Razer common' HID driver that claims the
mouse's control collection exclusively before Chrome/WebHID ever sees it. The
probe fallback from #258 can't recover from that -- there's no vendor
collection granted to probe -- so it was falling through to the generic
'not a supported control interface' message with no lead for the user.

requestSupportedClient() now checks whether any granted Razer device actually
exposed the Generic Desktop Mouse collection (usagePage 0x01, usage 0x02) the
driver needs. If none did, the error names the likely cause and the concrete
fix (pull the driver out of the driver store with pnputil so Windows Update
can't silently reinstall it, not just uninstall it from Device Manager)
instead of leaving the user to guess.

Claude-Session: https://claude.ai/code/session_01XbYSu8D3cu3c7vbEyJbacn
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying openmouse with  Cloudflare Pages  Cloudflare Pages

Latest commit: b162d8a
Status: ✅  Deploy successful!
Preview URL: https://bc3c73b3.openmouse.pages.dev
Branch Preview URL: https://fix-razer-windows-driver-hin.openmouse.pages.dev

View logs

@snekxs
snekxs merged commit 7b5d736 into main Sep 12, 2026
6 checks passed
@snekxs
snekxs deleted the fix/razer-windows-driver-hint branch September 12, 2026 20:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant