{
  "api_version": "1.0.0",
  "slug": "womier-m68-he-keyboard-config-protocol-webhid-claude",
  "url": "https://reversedwithai.com/p/womier-m68-he-keyboard-config-protocol-webhid-claude",
  "markdown_url": "https://reversedwithai.com/p/womier-m68-he-keyboard-config-protocol-webhid-claude.md",
  "json_url": "https://reversedwithai.com/p/womier-m68-he-keyboard-config-protocol-webhid-claude.json",
  "title": "Reverse engineered the Womier M68 HE keyboard configuration protocol with Claude",
  "tagline": "A keyboard protocol decoded from the vendor app, with a WebHID app and a Linux command line tool.",
  "summary": "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.",
  "target": {
    "name": "Womier M68 HE keyboard (Nuvoton M484)",
    "type": "firmware",
    "type_label": "Firmware and hardware"
  },
  "platform": "WebHID, Linux, Ghidra",
  "models": [
    "Claude"
  ],
  "tools": [
    "Ghidra",
    "WebHID"
  ],
  "outcome": "works",
  "outcome_label": "Works",
  "human_effort": null,
  "time_spent": null,
  "cost": null,
  "license": null,
  "checks": {
    "source_available": "yes",
    "repro_steps": null,
    "real_hardware": null,
    "independently_verified": null
  },
  "author": {
    "name": "gtalusan",
    "url": "https://github.com/gtalusan"
  },
  "sources": {
    "repository": "https://github.com/gtalusan/womier-m68-webhid",
    "writeup": null,
    "discussions": [],
    "all": [
      "https://github.com/gtalusan/womier-m68-webhid"
    ]
  },
  "image": null,
  "commit_history": null,
  "added_at": "2026-11-20T10:44:22.801256+00:00",
  "updated_at": "2026-11-20T10:44:22.801256+00:00",
  "sources_reviewed_at": "2026-11-20T10:44:22.801256+00:00",
  "reviewed_by": "automated",
  "human_notes": null,
  "reproduce": null,
  "body_md": "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.\n\n### How it was done\n\nThe 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.\n\n### Results\n\nThe 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.",
  "ai_use_excerpts": null
}
