Saltar a contenido

Vocalinux

Herramienta de dictado por voz 100% offline en español.

Requisitos

  • Equipo: Laptop con Elementary OS 8
  • Micrófono USB (ej. UGREEN CM769)

Instalación

Descarga e instala Vocalinux usando su script de instalación oficial:

curl -fsSL raw.githubusercontent.com/jatinkrmalik/vocalinux/main/install.sh -o /tmp/vl.sh && bash /tmp/vl.sh

Durante el proceso: - Si pregunta sobre la versión de Ubuntu → escribe y y continúa. - Selecciona la opción 1 (whisper.cpp — recomendado). - Al finalizar, selecciona "Yes, start on login".

Descargar modelo base en español

Descarga el modelo base de Whisper. Este modelo (~74MB) ofrece una excelente relación entre velocidad y precisión en español:

wget -O ~/.local/share/vocalinux/models/whispercpp/ggml-base.bin https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.bin

Nota: Existe un modelo small (~465MB) con mejor precisión, pero puede ser más lento al procesar en CPU.

Configuración y Micrófono

Verificar el nombre del micrófono USB

Antes de editar la configuración, debes confirmar que el nombre de tu dispositivo de entrada de audio (micrófono) sea el correcto:

pactl list sources short

Busca la línea que comienza con alsa_input.usb-... y cuyo estado sea RUNNING. Copia el nombre exacto del dispositivo.

Editar configuración

Abre el archivo de configuración de Vocalinux:

nano ~/.config/vocalinux/config.json

Reemplaza su contenido con el siguiente JSON, asegurándote de usar el nombre de micrófono copiado en el paso anterior dentro de device_name:

{
  "speech_recognition": {
    "engine": "whisper_cpp",
    "language": "es",
    "whisper_cpp_model_size": "base"
  },
  "audio": {
    "device_name": "alsa_input.usb-JinAudio_UGREEN_USB_MIC-CM769_202408060037-00.analog-stereo"
  }
}

Guarda los cambios (Ctrl+O → Enter) y sal de nano (Ctrl+X).

Lanzamiento

Para iniciar la aplicación manualmente:

vocalinux

Uso

Una vez que la aplicación esté corriendo, utiliza los siguientes atajos y comandos:

Acción Comando / Atajo
Activar dictado Doble tap de Ctrl
Detener dictado Doble tap de Ctrl

Solución de problemas (reinicio en caso de cuelgue):
Si la aplicación se bloquea, puedes reiniciarla forzando su cierre y eliminando su archivo de bloqueo con el siguiente comando:

rm -f ~/.local/share/vocalinux/instance.lock && pkill -9 -f vocalinux; sleep 1 && vocalinux

Notas

  • Vocalinux está configurado para arrancar automáticamente con el sistema (su script añadió el autostart correspondiente).