# OBOX Controller ViGEm Driver: a Windows client for the Snail OBox gamepad

> OBOX Controller ViGEm Driver implements a Windows client for the Snail OBox Bluetooth gamepad using a documented HID protocol. Its Rust driver maps buttons, sticks and triggers to a ViGEmBus Xbox 360 controller and sends rumble and LED commands through HID output reports; the repository also includes a Python prototype.

- 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/ffexis/obox-controller-vigem>
- Primary source: <https://github.com/ffexis/obox-controller-vigem/blob/a8d54f32fa9a8f6a32bd142de27c11492a7ad85e/docs/HID_PROTOCOL.md>
- Catalog page: <https://awesomerea.org/resources/obox-controller-vigem-case/>
- Record JSON: <https://awesomerea.org/resources/obox-controller-vigem-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/obox-controller-vigem-case/index.md)

## Requirements & limits

- **Prerequisites:** Snail OBox Bluetooth gamepad and Windows.
- **Prerequisites:** ViGEmBus driver; HidHide is optional.
- **Limits:** Only one controller is supported at a time.
- **License:** MIT license.

## Primary sources

1. <https://github.com/ffexis/obox-controller-vigem/blob/a8d54f32fa9a8f6a32bd142de27c11492a7ad85e/docs/HID_PROTOCOL.md>
2. <https://github.com/ffexis/obox-controller-vigem/blob/a8d54f32fa9a8f6a32bd142de27c11492a7ad85e/README.md>

## More in Protocols

- [OsmoFresh Quella Pro: hardware and UART protocol investigation](https://awesomerea.org/resources/osmofresh-quella-pro-hardware-case/index.md) · Case study
- [Colorful 2F4C:1018: reconstructing a motherboard ARGB HID interface](https://awesomerea.org/resources/colorful-2f4c-openrgb-case/index.md) · Case study
- [Deli XiangYinBao X1: reconstructing a Bluetooth label printer protocol](https://awesomerea.org/resources/deli-xiangyinbao-x1-protocol-case/index.md) · Case study
- [KardiaMobile 6L Unlocked: a direct BLE ECG client](https://awesomerea.org/resources/kardiamobile-6l-unlocked-case/index.md) · Case study
- [Elan 04f3:0903: reconstructing a fingerprint sensor's Linux interface](https://awesomerea.org/resources/elan-0903-fingerprint-linux-case/index.md) · Case study
- [FIIL 耳机控制: a Windows client for FIIL headphone BLE commands](https://awesomerea.org/resources/fiil-headphone-control-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.