Knurl 1.0.0

A native macOS app for configuring cheap USB macro keypads — the kind with a few
keys and a knob that ship with Windows-only software, or none at all.

What it does

• Maps each key and each knob movement to a shortcut, a media key or a mouse action
• Global keys plus per-app overrides — the keypad follows whichever app is in front
• Templates that fill the whole pad at once, resolved against your keyboard layout
  rather than assuming a US one
• Backlight effect, speed and colour, read from the keypad and written back live
• Reads what the hardware actually holds, so the window can never disagree with it

Protocols

Two are ported from rOzzy1987/MacroPad.
The third — the SDCX / Huali family, used by pads that the vendor configures with
a browser tool — was reverse engineered here and verified against the hardware:
reading the key table returned the Ctrl+A those keys actually type, and a write
read back byte for byte. The frame format is documented in the README.

Installing

Unzip and move Knurl.app to Applications.

The first launch needs one extra step. This build is not signed with an Apple
Developer ID, which needs a paid account, so macOS will say it cannot be opened.
Right-click the app and choose Open, then Open again. Once only.

The README has the fallback if that does not work, and you can build it yourself
from source with ./scripts/build-app.sh if you would rather not trust a binary.

Known limits

• Mouse actions and multi-key macros are not implemented for the SDCX family; the
  app says so rather than writing a guess into the key table
• The live press animation only works while the window is focused, and not for
  media keys, which the system takes before an app sees them