<!-- Canonical page: https://reversedwithai.com/p/womier-m68-he-keyboard-config-protocol-webhid-claude -->
Canonical page: https://reversedwithai.com/p/womier-m68-he-keyboard-config-protocol-webhid-claude

# Reverse engineered the Womier M68 HE keyboard configuration protocol with Claude

> A keyboard protocol decoded from the vendor app, with a WebHID app and a Linux command line tool.

The README says the config protocol was reverse engineered from the Windows-only software and checked in Ghidra. All 24 commits carry Claude Code co-author trailers.

## Key facts

- Target: Womier M68 HE keyboard (Nuvoton M484)
- Category: Firmware and hardware
- Platform: WebHID, Linux, Ghidra
- Models: Claude
- Tools: Ghidra, WebHID
- Outcome: Works
- Checks: Source available: yes; Repro steps: not reported; Real hardware: not reported; Verified by others: not reported
- Author: [gtalusan](https://github.com/gtalusan)
- Added: 2026-11-20
- Updated: 2026-11-20
- Sources reviewed: 2026-11-20 (automated reviewer)

## What was done

The author reverse engineered the configuration protocol of the Womier M68 HE keyboard (VID 0416, PID 7372, Nuvoton M484, firmware V1_11_05) from the Windows-only vendor software and built two configurators from it: a browser app over WebHID and a Linux command line tool.

### How it was done

The notes folder has 15 numbered write-ups, and the README says the frame layouts were verified with Ghidra on the vendor library, for example for the neon mode, plus macOS probe evidence. All 24 commits carry a Claude Code co-author trailer. The tree holds the web app, the command line package and the notes, with no vendor executables.

### Results

The browser app offers all 15 light effects with the vendor app's parameter set, key remapping with a byte-verified upload, and a keyboard render. The README marks behaviours as verified against the device or the vendor app.

## Sources

- [Repository](https://github.com/gtalusan/womier-m68-webhid)

Figures are reported by the author and not measured by this site, except the commit history. Entry drafted with AI from the linked sources and checked against them.

Cite as: gtalusan (2026). Reverse engineered the Womier M68 HE keyboard configuration protocol with Claude. Reversed with AI. https://reversedwithai.com/p/womier-m68-he-keyboard-config-protocol-webhid-claude
