# 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.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/Altureus/Windows-Switch2-Pro-Controller>
- Primary source: <https://github.com/Altureus/Windows-Switch2-Pro-Controller/blob/2292326d46fdb53ccf69e576c058d017e384e2a6/README.md>
- Catalog page: <https://awesomerea.org/resources/windows-switch2-pro-controller-case/>
- Record JSON: <https://awesomerea.org/resources/windows-switch2-pro-controller-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/windows-switch2-pro-controller-case/index.md)

## 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.

## Primary sources

1. <https://github.com/Altureus/Windows-Switch2-Pro-Controller/blob/2292326d46fdb53ccf69e576c058d017e384e2a6/README.md>
2. <https://github.com/Altureus/Windows-Switch2-Pro-Controller/blob/2292326d46fdb53ccf69e576c058d017e384e2a6/procon2/README.md>

## More in Protocols

- [cyberboard-cli: reconstructing CyberBoard R4 configuration writes](https://awesomerea.org/resources/cyberboard-cli-case/index.md) · Case study
- [gm1356-recordings: reading a sound meter through its USB-HID protocol](https://awesomerea.org/resources/gm1356-recordings-case/index.md) · Case study
- [TwoTrees SK1: reconstructing the display UART interface](https://awesomerea.org/resources/twotrees-sk1-display-case/index.md) · Case study
- [KW330 OBD Data Access: reconstructing the scanner's USB data stream](https://awesomerea.org/resources/kw330-obd-datastream-case/index.md) · Case study
- [AstralPool Halo Cloud: reconstructing chlorinator cloud control](https://awesomerea.org/resources/astralpool-halo-cloud-case/index.md) · Case study
- [zen-go-tui: reconstructing Zen Go USB HID controls](https://awesomerea.org/resources/zen-go-tui-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.