mecha-logMecha Docs
Extensions

Keyboard

A programmable keyboard extension built on Vial-QMK

Overview

Comet Keyboard is a custom programmable keyboard designed for power users, developers, and serial texters likewise.
It is built on Vial-QMK, enabling real-time remapping while also supporting advanced firmware-level behaviors that go beyond standard QMK features, and includes an integrated touchpad for pointer input and navigation.

The design emphasizes ergonomic efficiency and minimal finger travel, with an architecture optimized for symbol-heavy workflows, intuitive layer usage, and clear visual feedback. By combining real-time GUI remapping, the extension delivers both flexibility and predictability without sacrificing comfort.


Mecha Comet Keyboard

Hardware Specifications


Firmware Architecture

The firmware is built on Vial-QMK, that extends QMK with a secure, persistent configuration interface, allowing keyboards to be remapped in real time. It combines the robustness and flexibility of QMK’s firmware architecture with a lightweight GUI that communicates directly with the keyboard over USB. Allowing modifications in real-time. It also provides:

  • USB HID compliance
  • Real-time key remapping via Vial GUI
  • Persistent configuration storage
  • Standard QMK hooks

Keymapping and Layer Design

The keyboard uses three primary layers:

Base Layer (Layer 0)

  • Standard alphanumeric input
  • Custom Caps / Fn / Space behavior
  • Navigation keys
  • Mouse buttons

Fn Sticky Layer (Layer 1)

  • Activated via Fn tap
  • One-shot (auto-clears after a keypress)
  • Contains symbols and navigation shortcuts
@#$_&-+()

Fn Hold Layer (Layer 2)

  • Activated via Fn hold
  • Active only while Fn is physically held
  • Function keys and extended symbols
~'%^|\={}

Custom Key Behaviors

Caps Key (CAPS_SFT)

Caps behaves as a dual-function key:

  • Hold → Left Shift
  • Double Tap → Caps Lock toggle

Fn Key (FN_KEY)

Fn is implemented as a layer key with sticky support:

ActionResult
TapSticky Layer 1
HoldMomentary Layer 2
Release after useSticky cleared

Space Key (KC_SPC)

Space has a smart punctuation feature:

  • Single Tap → Space
  • Double Tap. (period + space)

Vial Integration

The firmware is compiled with Vial enabled, allowing:

  • Live remapping
  • Layer visualization
  • Persistent configuration storage

You can download and install Vial from the homepage and follow their guide here to better customize your keyboard.

Vial-GUI

Remapping Guide

What You Can Do With Vial

  • Remap normal keys on any layer

  • Have your own custom macros and key-combos

  • Rearrange keys to match your preferred keyboard layout (QWERTY, Dvorak, custom, etc.)


Default Combo Cheatsheet

Physical Key / ActionMapped To
Action L1Escape
Action L2Mouse Left Click
Action R2Mouse Right Click
Action R1Super / Windows Key
ShiftDouble Tap → Caps Lock
Single Tap → Sticky / Combine
FnDouble Tap → Latch Fn Key
Single Tap → Sticky / Combine
Q-PExample:
Default → q
Shift + Q → Q
Fn + Q → 1
Super + Q → F1
A-LExample:
Default → a
Shift + A → A
Fn + A → @
Hold Fn + A → ~
Fn + BackspaceDelete
Arrow KeysUp, Down, Left, Right
Space BarSingle Tap → Space
Double Tap → . + Space
TabFn + Arrow Right → Tab
Fn + Arrow Left → Back Tab

On this page