A 3×3 mechanical macropad built around a Pro Micro (ATmega32u4) running QMK. This repo includes a QMK keymap, a keyboard.json definition, a single-file browser configurator that generates keymap.c, and a Windows batch script to auto-apply + compile new keymaps.

Links:

• https://youtube.com/shorts/4B8f0nyeBfY?feature=share
• https://youtu.be/FJb8W2D7UVc

• Firmware macros (QMK): keymap.c
  Implements 9 custom macro keycodes and handles them in process_record_user().
• Keyboard definition (QMK JSON): keyboard.json
  Defines the 3×3 matrix, diode direction, Pro Micro pin mapping, and layout coordinates.
• Offline configurator (single HTML file): macropad-config-tool.html
  Click keys, choose a macro type, then export a ready-to-compile keymap.c.
• Automation script (Windows): update-keymap.bat
  Watches your Downloads folder for keymap.c, backs up the existing one, copies the new file into your QMK keymap folder, and runs qmk compile.

The current keymap.c ships with a few common macros wired in:

• Key 1: Ctrl+C
• Key 2: Ctrl+V
• Key 3: Alt+Tab
• Key 4: Ctrl+Shift+Esc
• Key 5: Ctrl+A
• Key 6: Win+L
• Keys 7–9: empty placeholders

There’s also a timestamped backup file included: keymap_backup_20250829_215935.c.

• Uses event delegation + DOM events via addEventListener to manage key selection and inputs.
• Exports files client-side using Blob + URL.createObjectURL (no server needed).
• Imports saved configs with FileReader to reload a JSON profile.
• Generates C output with template literals (clean string assembly) and escapes quotes safely.
• UI layout is done with CSS Grid (display: grid) and square keys via aspect-ratio.

• Defines macros as custom keycodes starting at SAFE_RANGE to avoid collisions with built-in keycodes.
• Implements all macro behavior in process_record_user so key handling stays centralized.
• Uses QMK’s string/macro helpers like SEND_STRING and SS_* sequences for modifiers and taps.

• Polls for a downloaded keymap.c, then creates a timestamped backup before overwriting.
• Runs QMK CLI compilation (qmk compile) after copying the new keymap.
• Uses conservative defaults: auto-flash is present but commented out.

• QMK Firmware + QMK CLI (required for building): https://qmk.fm/
  The batch script assumes you have qmk on PATH and a local qmk_firmware checkout.
• Browser-only UI (no build tools, no dependencies): plain HTML/CSS/JS.
  Fonts are a system stack (Segoe UI, Tahoma, etc.) — no external web fonts used.

.
├── assets/
├── keymap.c
├── keymap_backup_20250829_215935.c
├── keyboard.json
├── macropad-config-tool.html
└── update-keymap.bat