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

Prejsť na obsah dokumentácie
Keebye Docs

Diktovanie

Klávesa push-to-talk, podržanie verzus ťuknutie, čo ukazuje pilulka, ako sa vkladá text a kam Keebye odmieta písať.

Stlačte klávesu push-to-talk, hovorte, pustite. Prepis prebehne nad celou výpoveďou po pustení klávesy a text sa vloží do aplikácie, ktorá je práve vpredu.

Klávesa push-to-talk

Nastavenia › Push-to-talk hotkey: "Hold this key to dictate; release to insert." Zmeny sa prejavia okamžite.

  • Fn / Globe (na Windows pravý Ctrl)
  • Ľavý ⌘ (na Windows ľavý kláves Windows)
  • Pravý ⌘, predvolený (na Windows pravý kláves Windows)
  • Ľavý ⌥ (na Windows ľavý Alt)
  • Pravý ⌥ (na Windows pravý Alt)

Podržanie alebo ťuknutie

  • Stlačením klávesy sa nahrávanie spustí okamžite.
  • Pustenie po 400 ms a viac: podržanie na hovorenie. Nahrávanie sa ukončí a text sa vloží.
  • Pustenie skôr ako po 400 ms: ťuknutie. Nahrávanie pokračuje. Druhé ťuknutie ho ukončí a text vloží.
  • Esc zruší prebiehajúce nahrávanie. Nič sa nevloží.
  • Jedna výpoveď je obmedzená na 300 sekúnd (5 minút), potom sa nahrávanie samo ukončí a text sa vloží.

Pilulka

Pilulka je malý, trvale viditeľný panel prepúšťajúci kliknutia, umiestnený dole v strede vašej hlavnej obrazovky, 96 pt nad spodným okrajom. Na Macu sa zobrazuje na všetkých plochách a nikdy nepreberá fokus.

  • V pokoji: symbol mikrofónu.
  • "Downloading speech model… NN%" počas sťahovania modelu, alebo "Model download failed — reopen Keebye to retry".
  • "Listening…" → "Transcribing…" → "Inserting…" v priebehu diktovania.
  • Krátke správy približne na 2,6 sekundy: "Couldn't insert: <reason>", "Text left on clipboard — paste manually" alebo "Dictation paused: secure input on (<App>)".

Ako sa vkladá text

Vloženie (rýchle), predvolená možnosť: Keebye si uloží obsah schránky, zapíše prepis, syntetizuje ⌘V (na Windows Ctrl+V) a po 250 ms obnoví predchádzajúci obsah schránky, ak ju stále vlastní Keebye. Na Macu je prepis dočasná položka schránky, ktorú správcovia schránky preskakujú; na Windows sa obnovuje len obyčajný text. "Restore clipboard after paste" je predvolene zapnuté.

V Terminal.app, iTerm2, Warp, WezTerm a kitty na Macu a vo Windows Terminal, príkazovom riadku a PowerShelli na Windows sa vloženie rozdelí na časti s najviac 2000 bajtmi a 50 ms rozostupmi.

Písanie (terminály / SSH / ľubovoľné rozloženie): Keebye posiela stlačenia klávesov v Unicode bez toho, aby siahol na schránku, na Macu po 16 znakoch s odstupom 4 ms. Nezávisí od rozloženia klávesnice a funguje cez SSH aj v tmuxe. Ak písanie zlyhá, text skončí v schránke a pilulka zobrazí "Text left on clipboard — paste manually".

Polia s heslom a zabezpečený vstup

Ak je na Macu zapnutý zabezpečený vstup alebo má fokus pole s heslom, Keebye nezapíše do schránky nič a zobrazí "Couldn't insert: Secure input is active (<App>) — dictation is blocked" alebo "Couldn't insert: A password field is focused — dictation is blocked". Takéto diktovania sa do histórie neukladajú nikdy. Kontrola po 5 sekundách navyše upozorňuje "Dictation paused: secure input on (<App>)", kým zabezpečený vstup trvá.

Teplý mikrofón

Stream mikrofónu sa spustí pri prvom diktovaní a potom ostáva bežať počas celého behu aplikácie, takže systémový indikátor používania mikrofónu po prvom použití svieti ďalej. Na začiatok každej výpovede sa pridáva kĺzavý 500 ms predstih. Prvé diktovanie v relácii môže stále zaplatiť latenciu štartu streamu a slová vyslovené pred týmto 500 ms bufferom sa stále môžu odrezať. Zvuk sa prevzorkuje na 16 kHz mono a zmena zariadenia sa rozpozná do jednej sekundy.