# shark-k86-mac: a client for the Attack Shark K86 HID protocol

> shark-k86-mac reconstructs the Attack Shark K86 keyboard's vendor HID controls as a Python CLI and library for macOS and Linux. Its clean-room protocol notes describe 64-byte feature reports, checksums and opcodes; the client controls lighting and the TFT screen and reads device information.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-06
- Original resource: <https://github.com/RaphaelCaputo2/shark-k86-mac>
- Primary source: <https://github.com/RaphaelCaputo2/shark-k86-mac/blob/f9c8910637e0f42ee6f51a530582077570f1abd9/PROTOCOL.md>
- Catalog page: <https://awesomerea.org/resources/shark-k86-mac-case/>
- Record JSON: <https://awesomerea.org/resources/shark-k86-mac-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/shark-k86-mac-case/index.md)

## Requirements & limits

- **Prerequisites:** An Attack Shark K86 connected by USB in Win + USB mode is required; other models are untested.
- **Prerequisites:** Python 3.8+, hidapi and Pillow are required.
- **License:** MIT License.

## Primary sources

1. <https://github.com/RaphaelCaputo2/shark-k86-mac/blob/f9c8910637e0f42ee6f51a530582077570f1abd9/PROTOCOL.md>
2. <https://github.com/RaphaelCaputo2/shark-k86-mac/blob/f9c8910637e0f42ee6f51a530582077570f1abd9/README.md>

## More in Protocols

- [fitdays: reconstructing a smart-scale cloud client](https://awesomerea.org/resources/fitdays-protocol-case/index.md) · Case study
- [trvision: implementing Thermalright Vision USB display control](https://awesomerea.org/resources/trvision-case/index.md) · Case study
- [pocket-client: a BLE client for the Pocket voice recorder](https://awesomerea.org/resources/pocket-client-case/index.md) · Case study
- [KeyAxis: decoding a magnetic keyboard's analog HID stream](https://awesomerea.org/resources/keyaxis-keyboard-hid-case/index.md) · Case study
- [A.O. Smith water heater: local CTA-2045 control and protocol findings](https://awesomerea.org/resources/aosmith-water-heater-case/index.md) · Case study
- [j2208-band-tools: a direct client for the J2208 fitness-band protocol](https://awesomerea.org/resources/j2208-band-tools-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.