Dictarea

Apeși tasta push-to-talk, vorbești, dai drumul. Transcrierea rulează pe toată rostirea după ce dai drumul, iar textul e inserat în aplicația care e în prim-plan.

Tasta push-to-talk

Settings › Push-to-talk hotkey: "Hold this key to dictate; release to insert." Schimbările se aplică imediat.

• Fn / Globe
• ⌘ stânga
• ⌘ dreapta (implicit)
• ⌥ stânga
• ⌥ dreapta

Ținut apăsat sau apăsat scurt

• Apăsarea tastei pornește înregistrarea imediat.
• Dai drumul după 400 ms sau mai mult: ținut apăsat ca să vorbești. Înregistrarea se oprește și textul e inserat.
• Dai drumul în mai puțin de 400 ms: apăsare scurtă. Înregistrarea rămâne pornită. O a doua apăsare scurtă oprește și inserează.
• Esc anulează o înregistrare în curs. Nu se inserează nimic.
• O singură rostire e limitată la 300 secunde (5 minute), apoi se oprește și se inserează automat.

Pastila

Pastila e un panou mic, mereu vizibil, prin care trec clicurile, aflat jos-centru pe ecranul principal, la 96 pt deasupra marginii de jos. Apare în toate Spaces și nu preia niciodată focusul.

• În repaus: o pictogramă de microfon.
• "Downloading speech model… NN%" cât timp se descarcă un model, sau "Model download failed — reopen Keebye to retry".
• "Listening…" → "Transcribing…" → "Inserting…" în timpul unei dictări.
• Mesaje scurte, timp de aproximativ 2,6 secunde: "Couldn't insert: <reason>", "Text left on clipboard — paste manually" sau "Dictation paused: secure input on (<App>)".

Cum e inserat textul

Lipire — "Paste (fast)" —, varianta implicită: Keebye reține conținutul clipboardului, scrie transcrierea ca element temporar de clipboard, pe care managerele de clipboard îl sar, sintetizează ⌘V și, după 250 ms, restaurează clipboardul anterior dacă Keebye e încă proprietarul lui. "Restore clipboard after paste" e activ implicit.

În Terminal.app, iTerm2, Warp, WezTerm și kitty, lipirea e împărțită în bucăți de cel mult 2000 bytes, cu pauze de 50 ms.

Tastare — "Typing (terminals / SSH / any layout)": Keebye trimite taste Unicode în bucăți de 16 caractere, la 4 ms distanță, fără să atingă clipboardul. E independentă de layout și merge prin SSH și tmux. Dacă tastarea eșuează, textul rămâne în clipboard și pastila arată "Text left on clipboard — paste manually".

Câmpurile de parolă și intrarea securizată

Dacă intrarea securizată e activă, sau dacă elementul cu focus e un câmp de parolă, Keebye nu scrie nimic în clipboard și arată "Couldn't insert: Secure input is active (<App>) — dictation is blocked" sau "Couldn't insert: A password field is focused — dictation is blocked". Dictările astea nu sunt salvate niciodată în istoric. O verificare la fiecare 5 secunde avertizează și cu "Dictation paused: secure input on (<App>)" cât timp intrarea securizată rămâne activă.

Microfonul cald

Fluxul de microfon pornește la prima dictare și rămâne apoi activ cât trăiește aplicația, de aceea indicatorul de microfon din macOS rămâne aprins după prima utilizare. La începutul fiecărei rostiri se adaugă un pre-buffer continuu de 500 ms. Prima dictare dintr-o sesiune poate plăti totuși latența de pornire a fluxului, iar cuvintele rostite înainte de acel buffer de 500 ms pot fi tăiate. Audio-ul e reeșantionat la 16 kHz mono, iar o schimbare de dispozitiv e detectată în mai puțin de o secundă.