Dettare

Premi il tasto push-to-talk, parla, rilascia. La trascrizione elabora l'intera frase dopo il rilascio, e il testo viene inserito nell'app in primo piano.

Il tasto push-to-talk

Settings › Push-to-talk hotkey: "Hold this key to dictate; release to insert." Le modifiche si applicano subito.

• Fn / Globe
• ⌘ sinistro
• ⌘ destro (predefinito)
• ⌥ sinistro
• ⌥ destro

Tenere premuto o toccare

• Premere il tasto avvia subito la registrazione.
• Rilascio dopo 400 ms o più: tieni premuto per parlare. La registrazione si ferma e il testo viene inserito.
• Rilascio prima di 400 ms: tocco. La registrazione resta attiva. Un secondo tocco ferma e inserisce.
• Esc annulla una registrazione in corso. Non viene inserito nulla.
• Una singola frase è limitata a 300 secondi (5 minuti), poi si ferma e viene inserita automaticamente.

La pillola

La pillola è un pannello piccolo, sempre visibile e trasparente ai clic, in basso al centro dello schermo principale, 96 pt sopra il bordo inferiore. Compare in tutti gli Spazi e non prende mai il focus.

• A riposo: un'icona di microfono.
• "Downloading speech model… NN%" mentre un modello si scarica, oppure "Model download failed — reopen Keebye to retry".
• "Listening…" → "Transcribing…" → "Inserting…" durante una dettatura.
• Messaggi brevi per circa 2,6 secondi: "Couldn't insert: <reason>", "Text left on clipboard — paste manually" o "Dictation paused: secure input on (<App>)".

Come viene inserito il testo

Paste (fast), il predefinito: Keebye fa una copia dei tuoi appunti, scrive la trascrizione come elemento temporaneo degli appunti che i gestori di appunti ignorano, sintetizza ⌘V e dopo 250 ms ripristina gli appunti precedenti se Keebye è ancora il proprietario degli appunti. "Restore clipboard after paste" è attivo di default.

In Terminal.app, iTerm2, Warp, WezTerm e kitty l'incolla viene spezzato in blocchi di massimo 2000 byte con pause di 50 ms.

Typing (terminals / SSH / any layout): Keebye invia battute Unicode in blocchi di 16 caratteri, a 4 ms di distanza, senza toccare gli appunti. È indipendente dal layout e funziona via SSH e dentro tmux. Se la digitazione non riesce, il testo resta negli appunti e la pillola mostra "Text left on clipboard — paste manually".

Campi password e input sicuro

Se l'input sicuro è attivo, o l'elemento che ha il focus è un campo password, Keebye non scrive nulla negli appunti e mostra "Couldn't insert: Secure input is active (<App>) — dictation is blocked" oppure "Couldn't insert: A password field is focused — dictation is blocked". Queste dettature non vengono mai salvate nella cronologia. Un controllo ogni 5 secondi avvisa anche con "Dictation paused: secure input on (<App>)" finché l'input sicuro resta attivo.

Il microfono caldo

Il flusso del microfono parte alla prima dettatura e poi resta attivo per tutta la vita dell'app, quindi l'indicatore del microfono di macOS resta acceso dopo il primo uso. All'inizio di ogni frase vengono aggiunti 500 ms di audio precedente, tenuti in un buffer circolare. La prima dettatura di una sessione può comunque pagare la latenza di avvio del flusso, e le parole dette prima di quel buffer da 500 ms possono ancora essere troncate. L'audio viene ricampionato a 16 kHz mono e un cambio di dispositivo viene rilevato entro un secondo.