# attack-shark-x11-driver: a client for the Attack Shark X11 HID settings protocol

> attack-shark-x11-driver reconstructs Attack Shark X11 mouse configuration over USB HID as a TypeScript client. It provides DPI, profile, button, macro, lighting and polling-rate controls, plus device-state reads. Its protocol notes draw on USBPcap and Wireshark captures, HID feature reports, official software analysis and firmware investigation.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-07
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/HarukaYamamoto0/attack-shark-x11-driver>
- Primary source: <https://github.com/HarukaYamamoto0/attack-shark-x11-driver/blob/247eda6153bd517e953f7505a133d43f923fe32f/README.md>
- Catalog page: <https://awesomerea.org/resources/attack-shark-x11-driver-case/>
- Record JSON: <https://awesomerea.org/resources/attack-shark-x11-driver-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/attack-shark-x11-driver-case/index.md)

## Requirements & limits

- **Prerequisites:** Requires an Attack Shark X11 mouse; wired and 2.4 GHz wireless connections are supported.
- **Prerequisites:** Developed and tested primarily on Linux, with Node.js and Bun support where the HID implementation is compatible.
- **Limits:** Bluetooth is untested; wake-up mode configuration and Left-Click Macro reports 0x32–0x33 are unfinished.
- **License:** MIT license.

## Primary sources

1. <https://github.com/HarukaYamamoto0/attack-shark-x11-driver/blob/247eda6153bd517e953f7505a133d43f923fe32f/README.md>
2. <https://github.com/HarukaYamamoto0/attack-shark-x11-driver/blob/247eda6153bd517e953f7505a133d43f923fe32f/docs/messages/README.md>

## More in Protocols

- [Hisense/Hitachi H-NET-Protocol: investigating heat-pump bus signaling](https://awesomerea.org/resources/hisense-h-net-protocol-case/index.md) · Case study
- [YenKeyControl: decoding the Yenkee YKB3700 Rogue keyboard protocol](https://awesomerea.org/resources/yenkeycontrol-case/index.md) · Case study
- [Deye Battery Serial Bus: decoding battery CAN frames](https://awesomerea.org/resources/deye-battery-serial-bus-case/index.md) · Case study
- [Bonaparte: reconstructing the Napoleon eFIRE Bluetooth control protocol](https://awesomerea.org/resources/bonaparte-efire-case/index.md) · Case study
- [skyrcUSB: reading skyRC chargers through a reconstructed protocol](https://awesomerea.org/resources/skyrcusb-case/index.md) · Case study
- [mqtt-energi: reconstructing myenergi device traffic](https://awesomerea.org/resources/mqtt-energi-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.