Codex Single Key Macro Configurator

Codex Single Key Macro Configurator is a browser-based setup tool for the Codex merch kit's single programmable key. It runs in Chrome or Edge on desktop and sends configuration directly to the device over WebHID, without installing native software.

The app is built for fast everyday use: connect the device, build a macro with the virtual keyboard, preview the result, and push it back to the key. It also supports simple mouse and media actions, plus a light/dark theme switch for comfortable use in different environments.

What It Does

• Connects to the supported device from the browser.
• Builds keyboard macros with a virtual keyboard.
• Supports simple mouse and media actions.
• Shows a live preview before writing to the device.
• Detects device connection and disconnection.
• Supports dark and light themes.

How To Use It

1. Open the app in Chrome or Edge on desktop.
2. Click Connect Device.
3. Build a macro using the virtual keyboard, or enable Manual edit if you want to type directly.
4. Check the preview panel.
5. Click Push To Device.

Macro Format

• Simple keyboard combo: CTRL+C
• Macro with delay: WIN+R, DELAY(0.6), C, M, D, ENTER
• Simple media action: MEDIA_MUTE
• Simple mouse action: MOUSE_RIGHT

Requirements

• Chrome or Edge on desktop
• WebHID enabled
• Supported device:
  • VID: 0x5131
  • PID: 0x2019

Development

Install dependencies:

npm install

Run the local dev server:

npm run dev

Run tests:

npm test

Build for production:

npm run build

Technical Notes

• Static client app built with Vite and modular JavaScript.
• HID transport lives in src/hid/device.js.
• Frame building lives in src/hid/protocol.js.
• Macro parsing and validation live in src/macro/parser.js.
• The UI lives in src/ui/app.js.

Reference Project

This implementation and behavior mapping were based on:

• TabbycatPie/CustomKeyboard

Notes

• This app only writes the device's single configurable key.
• It is not intended for Firefox, Safari, iOS, or Android.
• mouse and media are used as simple standalone actions, not as steps inside mixed keyboard macros.