For AI agents: full index at https://keebye.com/llms.txt

Sari la conținutul documentației
Keebye Docs

Dictarea

Tasta push-to-talk, ținut apăsat față de apăsat scurt, ce arată pastila, cum e inserat textul și unde refuză Keebye să scrie.

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 (Ctrl dreapta pe Windows)
  • ⌘ stânga (tasta Windows stânga pe Windows)
  • ⌘ dreapta, implicit (tasta Windows dreapta pe Windows)
  • ⌥ stânga (Alt stânga pe Windows)
  • ⌥ dreapta (Alt dreapta pe Windows)

Ț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. Pe Mac 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, sintetizează ⌘V (Ctrl+V pe Windows) și, după 250 ms, restaurează clipboardul anterior dacă Keebye e încă proprietarul lui. Pe Mac, transcrierea e un element temporar de clipboard, pe care managerele de clipboard îl sar; pe Windows se restaurează doar textul simplu. "Restore clipboard after paste" e activ implicit.

În Terminal.app, iTerm2, Warp, WezTerm și kitty pe Mac, și în Windows Terminal, Command Prompt și PowerShell pe Windows, 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 fără să atingă clipboardul; pe Mac, în bucăți de 16 caractere, la 4 ms distanță. 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ă

Pe Mac, 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 în uz al sistemului 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ă.