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 (Ctrl destro su Windows)
• ⌘ sinistro (tasto Windows sinistro su Windows)
• ⌘ destro, il predefinito (tasto Windows destro su Windows)
• ⌥ sinistro (Alt sinistro su Windows)
• ⌥ destro (Alt destro su Windows)

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. Su Mac 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, sintetizza ⌘V (Ctrl+V su Windows) e dopo 250 ms ripristina gli appunti precedenti se Keebye ne è ancora il proprietario. Su Mac la trascrizione è un elemento temporaneo degli appunti che i gestori di appunti ignorano; su Windows viene ripristinato solo il testo semplice. "Restore clipboard after paste" è attivo di default.

In Terminal.app, iTerm2, Warp, WezTerm e kitty su Mac, e in Windows Terminal, Prompt dei comandi e PowerShell su Windows, l'incolla viene spezzato in blocchi di massimo 2000 byte con pause di 50 ms.

Typing (terminals / SSH / any layout): Keebye invia battute Unicode senza toccare gli appunti, su Mac in blocchi di 16 caratteri a 4 ms di distanza. È 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

Su Mac, 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 di microfono in uso del sistema 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.