Solución de problemas

“Local Transcriber no se puede abrir”

Esto es Gatekeeper de macOS. La app está firmada y notarizada por Apple, pero Gatekeeper aún puede mostrar esto en el primer inicio.

Solución: Haz clic derecho en la app en Aplicaciones → selecciona Abrir → haz clic en Abrir en el diálogo. Solo necesitas hacer esto una vez.

No se captura audio

Si la app comienza a grabar pero no aparece texto:

1. Verifica el permiso de micrófono. Ve a Configuración del Sistema → Privacidad y Seguridad → Micrófono y asegúrate de que Local Transcriber esté activado.
2. Verifica el permiso de reconocimiento de voz. Ve a Configuración del Sistema → Privacidad y Seguridad → Reconocimiento de Voz y asegúrate de que Local Transcriber esté activado.
3. Reinicia la app después de otorgar permisos — macOS a veces no detecta los cambios de permisos hasta que se reinicia la app.
4. Verifica tu salida de audio. La app captura el audio del sistema desde la salida de audio de tu Mac. Si estás enrutando audio a través de un dispositivo externo que macOS no reconoce como salida predeterminada, la captura de audio del sistema puede no funcionar.

Solo se captura un lado de la llamada

Si ves tu propio habla pero no la de la otra persona (o viceversa):

• Audio del sistema (la otra persona) viene de la salida de audio de tu Mac. Asegúrate de que el audio de la llamada se reproduzca a través de los altavoces de tu Mac o auriculares conectados a tu Mac.
• Audio del micrófono (tu voz) viene del micrófono que tu Mac esté usando. Verifica en Configuración del Sistema → Sonido → Entrada que el micrófono correcto esté seleccionado.

La transcripción es imprecisa

El reconocimiento de voz en el dispositivo es bueno pero no perfecto. Algunas cosas que ayudan:

• Habla con claridad y evita murmurar.
• Reduce el ruido de fondo — cierra ventanas, silencia notificaciones.
• Usa auriculares con micrófono — esto proporciona la señal de audio más limpia.
• Espera al post-procesamiento — la transcripción en vivo es un borrador. El post-procesamiento (que se ejecuta automáticamente al detener) mejora significativamente la precisión.

El post-procesamiento parece atascado

El post-procesamiento típicamente toma de 10 a 30 segundos para una reunión de 30 minutos. Si parece atascado:

1. Verifica el estado. Mira la barra lateral — muestra “Procesando” con un indicador giratorio mientras trabaja.
2. Verifica el log. Abre Terminal y ejecuta:

   tail -f ~/.transcriber/engine.log

   Esto muestra lo que la app está haciendo en tiempo real.
3. La primera ejecución es más lenta. La primera vez que grabas, la app descarga modelos de voz (~50 MB). Esto solo ocurre una vez.

Los modelos no se cargan

En el primer inicio, la app descarga modelos de voz y diarización en el dispositivo. Esto requiere conexión a internet. Si los modelos no se cargan:

1. Verifica tu conexión a internet — los modelos se descargan desde los servidores de Apple.
2. Verifica el espacio en disco disponible — los modelos necesitan aproximadamente 200 MB de espacio libre.
3. Reinicia la app — la descarga se reintenta en el siguiente inicio.

Una vez descargados, los modelos se almacenan en caché y la app funciona completamente sin conexión.

La app no aparece en la barra de menú

Local Transcriber muestra un icono de micrófono en la barra de menú de macOS. Si no lo ves:

• Verifica el desbordamiento de la barra de menú. Si tienes muchos elementos en la barra de menú, macOS puede ocultar algunos. Busca un chevron > en la barra de menú.
• Asegúrate de que la app esté ejecutándose. Verifica en Monitor de Actividad que aparezca “Local Transcriber” o “Transcriber”.

El CLI no funciona

Si el comando transcriber no se encuentra después de instalar:

1. Abre una nueva ventana de terminal — la actualización del PATH requiere una nueva sesión de shell.
2. Reinstala — ve a Transcriber → Instalar CLI y Habilidad de Agente… en el menú de la app.
3. Verifica el enlace simbólico — ejecuta ls -la /usr/local/bin/transcriber para verificar que existe y apunta al bundle de la app.

¿Aún necesitas ayuda?

Revisa el log del motor para diagnósticos detallados:

tail -100 ~/.transcriber/engine.log

Si sigues con problemas, abre un issue en GitHub con la salida del log relevante.