Dictar

Prem la teva tecla push-to-talk, parla, deixa-la anar. La transcripció s'executa sobre tot l'enunciat quan la deixes anar, i el text s'insereix a l'app que tens al davant.

La tecla push-to-talk

Settings › Push-to-talk hotkey: "Hold this key to dictate; release to insert." Els canvis s'apliquen a l'instant.

• Fn / Globe
• ⌘ esquerra
• ⌘ dreta (predeterminada)
• ⌥ esquerra
• ⌥ dreta

Mantenir o tocar

• Prémer la tecla comença a gravar immediatament.
• Deixar-la anar als 400 ms o més: mantenir per parlar. La gravació s'atura i el text s'insereix.
• Deixar-la anar abans dels 400 ms: toc. La gravació continua. Un segon toc l'atura i insereix.
• Esc cancel·la una gravació en curs. No s'insereix res.
• Un sol enunciat està limitat a 300 segons (5 minuts); després s'atura i s'insereix automàticament.

La píndola d'estat

La píndola és un panell petit, sempre visible i travessable pels clics, al centre inferior de la pantalla principal, 96 pt per damunt de la vora inferior. Apareix a tots els espais i mai no pren el focus.

• En repòs: un símbol de micròfon.
• "Downloading speech model… NN%" mentre es baixa un model, o "Model download failed — reopen Keebye to retry".
• "Listening…" → "Transcribing…" → "Inserting…" durant un dictat.
• Missatges breus d'uns 2,6 segons: "Couldn't insert: <reason>", "Text left on clipboard — paste manually" o "Dictation paused: secure input on (<App>)".

Com s'insereix el text

Paste (fast), l'opció per defecte: el Keebye fa una còpia del teu porta-retalls, escriu la transcripció com a element transitori del porta-retalls que els gestors de porta-retalls ignoren, sintetitza ⌘V i, al cap de 250 ms, restaura el porta-retalls anterior si el Keebye encara n'és el propietari. "Restore clipboard after paste" està activat per defecte.

A Terminal.app, iTerm2, Warp, WezTerm i kitty, l'enganxat es divideix en fragments de com a màxim 2000 bytes amb pauses de 50 ms.

Typing (terminals / SSH / any layout): el Keebye envia pulsacions Unicode en fragments de 16 caràcters, cada 4 ms, sense tocar el porta-retalls. És independent de la disposició del teclat i funciona per SSH i dins de tmux. Si el tecleig falla, el text es queda al porta-retalls i la píndola mostra "Text left on clipboard — paste manually".

Camps de contrasenya i entrada segura

Si l'entrada segura està activa, o l'element amb focus és un camp de contrasenya, el Keebye no escriu res al porta-retalls i mostra "Couldn't insert: Secure input is active (<App>) — dictation is blocked" o "Couldn't insert: A password field is focused — dictation is blocked". Aquests dictats no es guarden mai a l'historial. Una consulta cada 5 segons també avisa "Dictation paused: secure input on (<App>)" mentre l'entrada segura continua activa.

El micròfon escalfat

El flux del micròfon s'inicia amb el teu primer dictat i després es manté actiu durant tota la vida de l'app, per això l'indicador de micròfon de macOS es queda encès després del primer ús. S'afegeix un pre-roll continu de 500 ms al començament de cada enunciat. El primer dictat d'una sessió encara pot pagar la latència d'inici del flux, i les paraules dites abans d'aquest coixí de 500 ms encara es poden tallar. L'àudio es remostreja a 16 kHz mono i un canvi de dispositiu es detecta en menys d'un segon.