Case study
Switch 2 Pro Controller: bridging its USB HID reports to Windows XInput
Windows-Switch2-Pro-Controller reconstructs the Switch 2 Pro Controller's USB wake and HID report behavior in a Windows bridge. It parses button and stick reports, forwards input through ViGEmBus as an Xbox 360 pad, and relays rumble back to the controller; an optional BLE path is also described.
- Targets
- Protocol
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Sources reviewed
- Evidence class
- C2 code & docs, no demo or download
- Stars
- 1
- Last commit
- 2026-06-23
- Language
- Python
- License (GitHub)
- MIT
GitHub data as of 2026-11-10
Evidence
- Observed
- Code and documentation observed; no download method or demo found.
- Checked
- 2026-11-08
Requirements & limits
- Prerequisites: Windows 10 or 11 x64, a USB-connected Switch 2 Pro Controller, Python 3 and the ViGEmBus driver.
- Prerequisites: The optional Bluetooth path requires bleak.
- License: MIT license; bundled third-party components have separate notices.
Cite
BibTeX
@misc{windows-switch2-pro-controller-case,
title = {{Switch 2 Pro Controller: bridging its USB HID reports to Windows XInput}},
howpublished = {\url{https://github.com/Altureus/Windows-Switch2-Pro-Controller}},
url = {https://github.com/Altureus/Windows-Switch2-Pro-Controller},
urldate = {2026-11-06},
note = {Awesome REA entry: \url{https://awesomerea.org/resources/windows-switch2-pro-controller-case/}}
}Plain text
Switch 2 Pro Controller: bridging its USB HID reports to Windows XInput. https://github.com/Altureus/Windows-Switch2-Pro-Controller (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/windows-switch2-pro-controller-case/
Useful? Star Awesome REA on GitHub2.4k
About this entry
The description was reviewed against primary sources.
Primary sources
- README.md GitHub · Altureus/Windows-Switch2-Pro-Controller · Revision 2292326
- procon2/README.md GitHub · Altureus/Windows-Switch2-Pro-Controller · Revision 2292326
More in Protocols
- cyberboard-cli: reconstructing CyberBoard R4 configuration writes · Case study
- gm1356-recordings: reading a sound meter through its USB-HID protocol · Case study
- TwoTrees SK1: reconstructing the display UART interface · Case study
- KW330 OBD Data Access: reconstructing the scanner's USB data stream · Case study
- AstralPool Halo Cloud: reconstructing chlorinator cloud control · Case study
- zen-go-tui: reconstructing Zen Go USB HID controls · Case study