Dictar

Pulsa tu tecla push-to-talk, habla y suelta. La transcripción se hace sobre toda la frase después de soltar, y el texto se inserta en la app que esté en primer plano.

La tecla push-to-talk

Settings › Push-to-talk hotkey: "Hold this key to dictate; release to insert." Los cambios se aplican al momento.

• Fn / Globe
• ⌘ izquierda
• ⌘ derecha (por defecto)
• ⌥ izquierda
• ⌥ derecha

Mantener o tocar

• Pulsar la tecla empieza a grabar de inmediato.
• Soltar a partir de 400 ms: mantener para hablar. La grabación para y el texto se inserta.
• Soltar antes de 400 ms: toque. La grabación sigue activa. Un segundo toque para e inserta.
• Esc cancela una grabación en curso. No se inserta nada.
• Una sola frase se corta a los 300 segundos (5 minutos); entonces para e inserta automáticamente.

La píldora

La píldora es un panel pequeño, siempre visible y que no recibe clics, centrado en la parte inferior de tu pantalla principal, a 96 pt del borde inferior. Aparece en todos los Espacios y nunca toma el foco.

• En reposo: un icono de micrófono.
• "Downloading speech model… NN%" mientras se descarga un modelo, o "Model download failed — reopen Keebye to retry".
• "Listening…" → "Transcribing…" → "Inserting…" durante un dictado.
• Mensajes breves durante unos 2,6 segundos: "Couldn't insert: <reason>", "Text left on clipboard — paste manually" o "Dictation paused: secure input on (<App>)".

Cómo se inserta el texto

Paste (fast), la opción por defecto: Keebye guarda una copia de tu portapapeles, escribe la transcripción como un elemento transitorio del portapapeles que los gestores de portapapeles ignoran, sintetiza ⌘V y, tras 250 ms, restaura tu portapapeles anterior si Keebye sigue siendo el dueño del portapapeles. "Restore clipboard after paste" está activado por defecto.

En Terminal.app, iTerm2, Warp, WezTerm y kitty el pegado se divide en trozos de 2000 bytes como máximo, con pausas de 50 ms.

Typing (terminals / SSH / any layout): Keebye envía pulsaciones Unicode en trozos de 16 caracteres, con 4 ms entre ellos, sin tocar el portapapeles. Es independiente de la distribución de teclado y funciona por SSH y en tmux. Si el tecleo falla, el texto se queda en el portapapeles y la píldora muestra "Text left on clipboard — paste manually".

Campos de contraseña y entrada segura

Si la entrada segura está activa, o el elemento con el foco es un campo de contraseña, Keebye no escribe nada en el portapapeles y muestra "Couldn't insert: Secure input is active (<App>) — dictation is blocked" o "Couldn't insert: A password field is focused — dictation is blocked". Esos dictados nunca se guardan en el historial. Una comprobación cada 5 segundos también avisa con "Dictation paused: secure input on (<App>)" mientras la entrada segura siga activa.

El micrófono caliente

El flujo del micrófono arranca en tu primer dictado y luego sigue activo durante toda la vida de la app, así que el indicador de micrófono de macOS se queda encendido tras el primer uso. Al principio de cada frase se añaden 500 ms de audio previo en rotación. El primer dictado de una sesión todavía puede pagar la latencia de arranque del flujo, y las palabras dichas antes de ese búfer de 500 ms todavía pueden cortarse. El audio se remuestrea a 16 kHz mono y un cambio de dispositivo se detecta en menos de un segundo.