Resolución de problemas
Qué significa cada mensaje que muestra Keebye y cómo arreglarlo, además de cómo restablecer la app.
Casi todos los problemas se reducen a un permiso, un modelo que falta o el dictado en pausa. Empieza por las comprobaciones rápidas y luego busca tu mensaje más abajo.
¿El hotkey no hace nada? Comprueba esto primero
- "Enable Dictation" está marcado en el menú de la barra de menús.
- Tienes la sesión iniciada y la prueba no ha terminado (Settings › Account).
- La accesibilidad está concedida en Ajustes del Sistema › Privacidad y seguridad › Accesibilidad.
- No hay ninguna entrada segura activa — por ejemplo la Entrada de teclado segura en Terminal, o un campo de contraseña con el foco.
Mensajes y qué significan
"Accessibility permission was revoked — reopen System Settings"
El permiso de accesibilidad faltaba al empezar la grabación. Abre Ajustes del Sistema › Privacidad y seguridad › Accesibilidad y activa Keebye. Keebye rearma el hotkey en menos de 2 segundos.
"Failed to start the global hotkey listener"
macOS rechazó el event tap. Concede el acceso de accesibilidad y vuelve a elegir tu tecla en Settings.
"Could not arm <Key> — grant Keebye Accessibility access, then pick it again." o "Could not switch to <Key>; still using <Key>."
Se rechazó el cambio de hotkey. Concede el acceso de accesibilidad y elige la tecla otra vez; hasta entonces Keebye sigue usando la tecla anterior.
"Microphone capture failed: <error>"
No hay dispositivo de entrada por defecto o el flujo de audio falló. Comprueba el dispositivo de entrada en Ajustes del Sistema › Sonido y que el acceso al micrófono esté concedido.
"Speech model still setting up — try again in a moment"
El modelo seleccionado no está en disco o no ha terminado de cargarse. Espera a que la píldora salga del estado de descarga, o pulsa "Download model" en Settings › Speech engine.
"Model download failed — reopen Keebye to retry"
Cinco intentos de descarga fallaron (red, error HTTP o suma de verificación distinta). Cierra y vuelve a abrir Keebye; la descarga se reanuda donde se quedó.
"Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition"
El motor Native (Apple Speech) está seleccionado sin autorización. Concede el Reconocimiento de voz o cambia a Parakeet o Canary.
"Apple Speech recognizer is not available for locale …", "Apple Speech recognized no speech" o "Apple Speech timed out after 15s"
Problemas del motor Native. Puede que haya que instalar el modelo de lenguaje on-device en Ajustes del Sistema › Teclado › Dictado; si no, habla antes de que pasen 15 segundos o cambia de motor.
"Couldn't insert: Secure input is active (<App>) — dictation is blocked" o "Couldn't insert: A password field is focused — dictation is blocked"
Hay un campo de contraseña con el foco o una app con la Entrada de teclado segura activada (Terminal, por ejemplo). Haz clic en un campo de texto normal o desactiva la Entrada de teclado segura. Es intencionado.
"Text left on clipboard — paste manually"
Falló la síntesis de ⌘V o de las pulsaciones. La transcripción está en tu portapapeles; pulsa ⌘V tú mismo.
"Dictation hit an internal error and was reset. Please try again."
El proceso de la sesión se recuperó de un fallo. Vuelve a dictar.
La ventana de onboarding se ha vuelto a abrir tras una actualización o una reinstalación
Un permiso de accesibilidad obsoleto. Quita Keebye de Ajustes del Sistema › Privacidad y seguridad › Accesibilidad con el botón −, vuelve a añadirlo y actívalo.
Restablecer Keebye
Cierra Keebye, borra ~/Library/Application Support/com.keebye.app/settings.json y quita el elemento del Llavero del servicio com.keebye.app, cuenta auth. Vuelve a abrirla y el onboarding empieza de nuevo. Los diagnósticos van solo a stderr.