{
  "added_at": "2026-11-09",
  "additional_evidence_urls": [
    "https://github.com/HarukaYamamoto0/attack-shark-x11-driver/blob/247eda6153bd517e953f7505a133d43f923fe32f/docs/messages/README.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "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.",
  "description_zh": "attack-shark-x11-driver 以 TypeScript 客户端实现 Attack Shark X11 鼠标的 USB HID 配置协议，支持 DPI、配置档、按键、宏、灯效和轮询率设置，以及设备状态读取。协议笔记记录了 USBPcap 与 Wireshark 抓包、HID 功能报告、官方软件分析和固件调查所得的发现。",
  "entry_url": "https://awesomerea.org/resources/attack-shark-x11-driver-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/attack-shark-x11-driver-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/HarukaYamamoto0/attack-shark-x11-driver/blob/247eda6153bd517e953f7505a133d43f923fe32f/README.md",
  "group": "cases",
  "id": "attack-shark-x11-driver-case",
  "json_url": "https://awesomerea.org/resources/attack-shark-x11-driver-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/attack-shark-x11-driver-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/attack-shark-x11-driver-case/index.md",
  "name": "attack-shark-x11-driver: a client for the Attack Shark X11 HID settings protocol",
  "name_zh": "attack-shark-x11-driver：Attack Shark X11 HID 设置协议客户端",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "Requires an Attack Shark X11 mouse; wired and 2.4 GHz wireless connections are supported.",
    "Developed and tested primarily on Linux, with Node.js and Bun support where the HID implementation is compatible.",
    "Bluetooth is untested; wake-up mode configuration and Left-Click Macro reports 0x32–0x33 are unfinished.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要 Attack Shark X11 鼠标；支持有线和 2.4 GHz 无线连接。",
    "主要在 Linux 上开发和测试；HID 实现兼容时支持 Node.js 和 Bun。",
    "蓝牙连接尚未测试；唤醒模式设置及 Left-Click Macro 的 0x32–0x33 报告尚未实现。",
    "MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/HarukaYamamoto0/attack-shark-x11-driver",
  "verification": "source-reviewed",
  "verified_at": "2026-11-07"
}