QMK es potentísimo, pero tiene un problema para el usuario final: cada cambio de tecla exige recompilar y reflashear. Eso está bien para ti, que montas el teclado, pero es una barrera para el cliente que solo quiere mover una tecla de sitio. Vial resuelve esto: aporta la edición gráfica sin recompilar. Es un fork de QMK (una copia del proyecto que evoluciona por su cuenta añadiendo funciones propias) con una característica clave: permite remapear el teclado en tiempo real desde una aplicación de escritorio, sin tocar C y sin volver a flashear. En este artículo entiendes qué es, lo configuras y ves por qué es la mejor entrega para alguien que no programa.

Qué es Vial exactamente

Vial son dos cosas que trabajan juntas:

• vial-qmk: un fork de QMK que incluye un módulo que escucha cambios y reescribe el keymap guardado en el propio teclado.
• La app Vial: una aplicación gráfica multiplataforma (Windows, Linux, macOS y también versión web) que detecta el teclado y te deja arrastrar y soltar teclas.

La idea es que el keymap vive en la memoria del teclado y la app lo edita al vuelo. Cambias una tecla, se aplica al instante, y queda guardado en el teclado aunque lo desconectes. No hay paso de compilación en el día a día.

Vial vs QMK Configurator (y vs VIA)

Conviene aclarar el panorama, porque hay tres herramientas que se confunden:

Herramienta	Cambios en tiempo real	Necesita reflashear	Define-keyboard
QMK (puro)	No	Sí, cada cambio	En el firmware
VIA	Sí	No	Requiere fichero JSON externo
Vial	Sí	No	Embebido en el firmware

La ventaja de Vial sobre el QMK Configurator clásico es obvia: el Configurator te genera un firmware que luego tienes que flashear; Vial aplica los cambios sin flashear nada. Y la ventaja sobre VIA (la otra app gráfica popular, de la que Vial deriva) es que Vial lleva la definición del teclado embebida dentro del propio firmware, así que la app reconoce el teclado automáticamente sin tener que cargarle un fichero JSON aparte (JSON es un formato de texto para describir datos de forma estructurada; aquí, la disposición física del teclado). Para el usuario final, eso es la diferencia entre “enchufo y funciona” y “busca el JSON correcto en internet”.

Preparar el firmware Vial (lo haces tú una vez)

El usuario no compila nunca, pero alguien (tú) tiene que flashear una vez el firmware Vial. El flujo es como QMK pero sobre el fork:

git clone https://github.com/vial-kb/vial-qmk.git
cd vial-qmk
qmk compile -kb crkbd -km vial
qmk flash -kb crkbd -km vial

El keymap Vial incluye un fichero adicional, vial.json, que describe la disposición física del teclado para que la app la dibuje. Para teclados ya soportados (el Corne lo está), no tienes que crearlo: viene en el keymap vial. Igual que en QMK, en un Corne flasheas cada mitad por separado.

Importante para la seguridad: Vial usa un mecanismo de “unlock” (desbloqueo) para evitar cambios accidentales. La primera vez, la app te pedirá mantener una combinación de teclas físicas para desbloquear la edición. Es a propósito, para que nadie reescriba tu teclado sin acceso físico.

Usar la app: lo que verá el cliente

Una vez flasheado, el flujo del usuario es trivial:

1. Descarga la app Vial (o abre la versión web en un navegador compatible con WebHID, como Chrome).
2. Conecta el teclado por USB.
3. La app lo detecta sola y muestra el layout del Corne en pantalla.
4. Hace clic en una tecla del dibujo, elige el nuevo keycode de la lista, y se aplica al instante.

Desde esa misma interfaz gráfica el usuario puede, sin escribir una línea de código:

• Reasignar cualquier tecla en cualquier capa.
• Editar las capas (layers) y qué activa cada una.
• Configurar tap-hold y home row mods con menús, ajustando el tapping term.
• Crear macros grabando secuencias.
• Definir combos (pulsar dos teclas a la vez para un tercer resultado).
• Ajustar RGB si el teclado lo lleva.

Todo se guarda en el teclado. Puede llevárselo a otro ordenador y mantiene su configuración, porque no depende del PC sino de la memoria del propio teclado.

Por qué es la mejor entrega para el usuario final

Cuando entregas un teclado a alguien que no programa, Vial es casi siempre la respuesta correcta. Las razones:

• Cero fricción: abre la app, enchufa, cambia. No instala toolchains, no compila, no busca ficheros.
• Experimentación sin miedo: como los cambios son instantáneos y reversibles, el cliente prueba layouts hasta encontrar el suyo sin riesgo de “romper” nada.
• Independencia: no te necesita a ti para cada ajuste. Le entregas el teclado con un keymap base sensato y él lo afina solo.
• Reversible: si se lía, restaura el keymap por defecto desde la propia app.

La pega de Vial es que no es tan ilimitado como escribir C a mano en QMK: las funciones muy exóticas (lógica personalizada con código propio) siguen requiriendo QMK puro. Pero para el 95% de los casos (remapear, capas, home row mods, macros, combos), Vial cubre todo y lo hace accesible.

Recomendación práctica

Para un teclado cableado destinado a un cliente que no programa, flashea Vial y entrégalo con un keymap base bien pensado. Acompáñalo de una nota de una página: cómo abrir la app, cómo desbloquear la edición y cómo cambiar una tecla. Así le das un teclado que es suyo de verdad, modificable sin depender de nadie. Para builds inalámbricos, sin embargo, Vial no es la vía (depende de USB y de QMK): ahí entra ZMK, que vemos a continuación.