Case study

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.

Targets: Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-07
Evidence class: C2 code & docs, no demo or download

Stars: 33
Last commit: 2026-11-01
Language: TypeScript
License (GitHub): MIT

GitHub data as of 2026-11-10

Copy as Markdown View JSON Cite

Evidence

Observed: Code, documentation and a download method observed; no demo found.
Checked: 2026-11-09

How evidence classes are assigned

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.

Cite

BibTeX

@misc{attack-shark-x11-driver-case,
  title = {{attack-shark-x11-driver: a client for the Attack Shark X11 HID settings protocol}},
  howpublished = {\url{https://github.com/HarukaYamamoto0/attack-shark-x11-driver}},
  url = {https://github.com/HarukaYamamoto0/attack-shark-x11-driver},
  urldate = {2026-11-07},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/attack-shark-x11-driver-case/}}
}

Plain text

attack-shark-x11-driver: a client for the Attack Shark X11 HID settings protocol. https://github.com/HarukaYamamoto0/attack-shark-x11-driver (accessed 2026-11-07). Awesome REA entry: https://awesomerea.org/resources/attack-shark-x11-driver-case/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

README.md GitHub · HarukaYamamoto0/attack-shark-x11-driver · Revision 247eda6
docs/messages/README.md GitHub · HarukaYamamoto0/attack-shark-x11-driver · Revision 247eda6