menyoki es una herramienta minimalista basada en terminal para la captura de pantalla y grabación de video. Su diseño de interacción permite a los usuarios definir y refinar las regiones de captura exclusivamente mediante el teclado, eliminando la necesidad de interacciones con el ratón. A continuación, se detalla el funcionamiento de sus combinaciones de teclas para el control preciso del área de grabación.

Ventajas de la Interacción por Teclado

A diferencia de las utilidades gráficas que dependen de arrastrar el cursor, menyoki ejecuta el modo de selección directamente en la consola. Al invocar comandos como menyoki capture o menyoki record, el estado de entrada cambia, habilitando un conjunto de atajos definidos en el módulo de utilidades de la aplicación. Esto garantiza un flujo de trabajo ininterrumpido y altamente eficiente para usuarios avanzados.

Combinaciones Principales de Control

Las siguientes teclas constituyen el núcleo para gestionar el ciclo de vida de la selección:

Nota: Las teclas de dirección son totalmente intercambiables con h, j, k, l para mantener la ergonomía en entornos Vim.

Refinamiento Preciso del Área

El ajuste fino se logra mediante la modulación de las teclas modificadoras junto con los ejes de movimiento:

• Contracción: Mantener LAlt y pulsar una dirección contrae el marco desde ese lado. Es ideal para eliminar elementos no deseados en los bordes.
• Expansión: Añadir LControl a la combinación anterior invierte la lógica, expandiendo el marco hacia el exterior para incluir contexto adicional.
• Traslación: Incorporar LShift permite mover el rectángulo de selección por la pantalla manteniendo su tamaño original, útil para seguir ventanas en movimiento.
• Factor de Escalado: Pulsar LAlt junto con teclas numéricas del 1 al 9 altera la velocidad de desplazamiento de los bordes. El valor 1 ofrece precisión a nivel de píxel, mientras que 9 maximiza la velocidad.
• Restablecimiento: La combinación LAlt-R revierte los márgenes internos a su estado inicial, corrigiendo errores de ajuste rápidamente.

Personalización mediante Argumentos CLI

Es posible reasignar las teclas de confirmación y cancelación directamente desde la línea de comandos. A continuación, se muestra un ejemplo modificado donde se utilizan teclas del sistema (Super) y controles alternativos:

# Reasignación de teclas para el modo de grabación
menyoki record --action-keys LSuper-Return,LAlt-F --cancel-keys LSuper-BackSpace,LControl-Z

# Aplicando la misma lógica para capturas estáticas
menyoki capture --action-keys LSuper-Return,LAlt-F --cancel-keys LSuper-BackSpace,LControl-Z

Para deshabilitar completamente la interacción por teclado y forzar un comportamiento puramente automatizado, se puede inyectar el flag --no-keys.

Persistencia en Archivo de Configuración

Para evitar pasar argumentos repetitivos, las preferencias pueden almacenarse en el archivo de configuración local. La estructura del documento TOML permite definir comportamientos específicos por modo:

[record]
action-keys = LSuper-Return,LAlt-F
cancel-keys = LSuper-BackSpace,LControl-Z

[capture]
action-keys = LSuper-Return,LAlt-F
cancel-keys = LSuper-BackSpace,LControl-Z

Tabla de Referencia Rápida

Resumen exhaustivo de las interacciones disponibles para los subcomandos de captura y grabación:

Ejemplo de Flujo de Trabajo

Para compilar la herramienta y ejecutar una grabación optimizada, se puede seguir el siguiente procedimiento:

git clone https://github.com/orhun/menyoki.git
cd menyoki && cargo build --release
./target/release/menyoki record mp4 --fps 60

Al ejecutarse, el modo de selección se activa. El usuario ajusta las dimensiones con LAlt + Flechas, reposiciona con LShift-LAlt + Flechas, y confirma con LSuper-Enter. Al presionar la misma tecla nuevamente, el archivo de video se genera en el directorio de trabajo.