鈱笍 Atajos de Teclado y Scripts¶
Filosof铆a de Integraci贸n
Voice2Machine no secuestra tu teclado. Proporciona scripts "at贸micos" que t煤 vinculas a tu gestor de ventanas favorito (GNOME, KDE, Hyprland, i3). Esto garantiza compatibilidad universal y cero consumo de recursos en segundo plano para escuchar teclas.
馃敆 Scripts Principales¶
Para activar las funciones, debes crear atajos globales que ejecuten estos scripts ubicados en scripts/.
1. Dictado (Toggle)¶
- Script:
scripts/v2m-toggle.sh - Funci贸n: Interruptor de grabaci贸n.
- Estado Inactivo: Inicia grabaci贸n 馃敶 (Sonido de confirmaci贸n).
- Estado Grabando: Detiene, transcribe y pega el texto 馃煝.
- Atajo Sugerido:
Super + Vo bot贸n lateral del mouse.
2. Refinado con IA¶
- Script:
scripts/v2m-llm.sh - Funci贸n: Mejora de texto contextual.
- Lee el portapapeles actual.
- Env铆a el texto al proveedor LLM configurado (Gemini/Ollama).
- Reemplaza el portapapeles con la versi贸n mejorada.
- Atajo Sugerido:
Super + G.
馃惂 Ejemplos de Configuraci贸n¶
GNOME / Ubuntu¶
- Ve a Configuraci贸n > Teclado > Atajos de teclado > Ver y personalizar.
- Selecciona Atajos personalizados.
- A帽ade nuevo:
- Nombre:
V2M: Dictar - Comando:
/home/tu_usuario/voice2machine/scripts/v2m-toggle.sh - Atajo:
Super+V
- Nombre:
Hyprland¶
En tu hyprland.conf:
bind = SUPER, V, exec, /home/$USER/voice2machine/scripts/v2m-toggle.sh
bind = SUPER, G, exec, /home/$USER/voice2machine/scripts/v2m-llm.sh
i3 / Sway¶
En tu config:
bindsym Mod4+v exec --no-startup-id /home/$USER/voice2machine/scripts/v2m-toggle.sh
bindsym Mod4+g exec --no-startup-id /home/$USER/voice2machine/scripts/v2m-llm.sh
鈿狅笍 Soluci贸n de Problemas¶
Permisos de Ejecuci贸n
Si el atajo parece "muerto", verifica que los scripts tengan permiso de ejecuci贸n:
bash
chmod +x scripts/v2m-toggle.sh scripts/v2m-llm.sh
Wayland vs X11
Los scripts detectan autom谩ticamente tu servidor gr谩fico. - X11: Usa xclip y xdotool. - Wayland: Usa wl-copy y wtype (aseg煤rate de tenerlos instalados si usas Wayland puro).
Latencia
Estos scripts usan comunicaci贸n por sockets crudos (raw sockets) para hablar con el demonio, asegurando una latencia de activaci贸n < 10ms. No inician una instancia de Python pesada cada vez.