Přejít na obsah dokumentace
Keebye Docs

Diktování

Klávesa push-to-talk, podržení versus klepnutí, co ukazuje pilulka, jak se vkládá text a kam Keebye odmítá psát.

Stiskněte klávesu push-to-talk, mluvte, pusťte. Přepis proběhne nad celou promluvou po puštění klávesy a text se vloží do aplikace, která je právě vpředu.

Klávesa push-to-talk

Nastavení › Push-to-talk hotkey: "Hold this key to dictate; release to insert." Změny se projeví okamžitě.

  • Fn / Globe
  • Levý ⌘
  • Pravý ⌘ (výchozí)
  • Levý ⌥
  • Pravý ⌥

Podržení nebo klepnutí

  • Stiskem klávesy se nahrávání spustí okamžitě.
  • Puštění po 400 ms a víc: podržení pro mluvení. Nahrávání skončí a text se vloží.
  • Puštění dřív než po 400 ms: klepnutí. Nahrávání pokračuje. Druhé klepnutí ho ukončí a text vloží.
  • Esc zruší probíhající nahrávání. Nic se nevloží.
  • Jedna promluva je omezená na 300 sekund (5 minut), pak se nahrávání samo ukončí a text se vloží.

Pilulka

Pilulka je malý, trvale viditelný panel propouštějící kliknutí, umístěný dole uprostřed hlavní obrazovky, 96 pt nad spodním okrajem. Zobrazuje se na všech plochách a nikdy nepřebírá fokus.

  • V klidu: symbol mikrofonu.
  • "Downloading speech model… NN%" během stahování modelu, nebo "Model download failed — reopen Keebye to retry".
  • "Listening…" → "Transcribing…" → "Inserting…" v průběhu diktování.
  • Krátké zprávy zhruba na 2,6 sekundy: "Couldn't insert: <reason>", "Text left on clipboard — paste manually" nebo "Dictation paused: secure input on (<App>)".

Jak se vkládá text

Vložení (rychlé), výchozí varianta: Keebye si uloží obsah schránky, zapíše přepis jako dočasnou položku schránky, kterou správci schránky přeskakují, syntetizuje ⌘V a po 250 ms obnoví předchozí obsah schránky, pokud ji Keebye stále vlastní. "Restore clipboard after paste" je ve výchozím stavu zapnuté.

V Terminal.app, iTerm2, Warp, WezTerm a kitty se vložení rozdělí na části po nejvýše 2000 bajtech s 50ms rozestupy.

Psaní (terminály / SSH / libovolné rozložení): Keebye posílá stisky kláves v Unicode po 16 znacích s odstupem 4 ms, aniž by sáhl na schránku. Nezávisí na rozložení klávesnice a funguje přes SSH i v tmuxu. Pokud psaní selže, text skončí ve schránce a pilulka zobrazí "Text left on clipboard — paste manually".

Pole s heslem a zabezpečený vstup

Pokud je zapnutý zabezpečený vstup nebo má fokus pole s heslem, Keebye nezapíše nic do schránky a zobrazí "Couldn't insert: Secure input is active (<App>) — dictation is blocked" nebo "Couldn't insert: A password field is focused — dictation is blocked". Taková diktování se nikdy neukládají do historie. Kontrola po 5 sekundách navíc upozorňuje "Dictation paused: secure input on (<App>)", dokud zabezpečený vstup trvá.

Teplý mikrofon

Stream mikrofonu se spustí při prvním diktování a pak zůstává běžet po celou dobu běhu aplikace, takže indikátor mikrofonu v macOS po prvním použití svítí dál. Na začátek každé promluvy se přidává klouzavý 500ms předstih. První diktování v relaci může stále zaplatit latenci startu streamu a slova vyslovená před tímto 500ms bufferem se stále mohou uříznout. Zvuk se převzorkuje na 16 kHz mono a změna zařízení se rozpozná do jedné sekundy.