Диктуване

Натиснете клавиша си за push-to-talk, говорете, отпуснете. Транскрипцията обработва цялото изказване, след като отпуснете, а текстът се вмъква в приложението, което е най-отпред.

Клавишът за push-to-talk

Settings › Push-to-talk hotkey: "Hold this key to dictate; release to insert." Промените влизат в сила веднага.

• Fn / Globe
• Левият ⌘
• Десният ⌘ (по подразбиране)
• Левият ⌥
• Десният ⌥

Задържане или докосване

• Натискането на клавиша започва записа веднага.
• Отпускане след 400 ms или повече: задържане, за да говорите. Записът спира и текстът се вмъква.
• Отпускане преди 400 ms: докосване. Записът остава включен. Второ докосване спира записа и вмъква текста.
• Esc отменя започнат запис. Нищо не се вмъква.
• Едно изказване е ограничено до 300 секунди (5 минути), след което записът спира и текстът се вмъква автоматично.

Индикаторът (pill)

Индикаторът е малък, винаги видим панел, през който щракванията минават, разположен долу в средата на основния ви екран, на 96 pt над долния край. Появява се във всички Spaces и никога не взема фокуса.

• В покой: символ на микрофон.
• "Downloading speech model… NN%", докато се изтегля модел, или "Model download failed — reopen Keebye to retry".
• "Listening…" → "Transcribing…" → "Inserting…" по време на диктовка.
• Кратки съобщения за около 2,6 секунди: "Couldn't insert: <reason>", "Text left on clipboard — paste manually" или "Dictation paused: secure input on (<App>)".

Как се вмъква текстът

Paste (fast), по подразбиране: Keebye запазва копие на клипборда ви, записва транскрипцията като временен елемент в клипборда, който мениджърите на клипборд пропускат, синтезира ⌘V и след 250 ms възстановява предишното съдържание на клипборда, ако Keebye все още е негов собственик. "Restore clipboard after paste" е включено по подразбиране.

В Terminal.app, iTerm2, Warp, WezTerm и kitty поставянето се разделя на части от най-много 2000 байта с интервали от 50 ms.

Typing (terminals / SSH / any layout): Keebye изпраща Unicode натискания на клавиши на части от 16 знака, през 4 ms, без да докосва клипборда. Не зависи от клавиатурната подредба и работи през SSH и tmux. Ако писането се провали, текстът остава в клипборда и индикаторът показва "Text left on clipboard — paste manually".

Полета за пароли и защитено въвеждане

Ако защитеното въвеждане е включено или елементът на фокус е поле за парола, Keebye не записва нищо в клипборда и показва "Couldn't insert: Secure input is active (<App>) — dictation is blocked" или "Couldn't insert: A password field is focused — dictation is blocked". Такива диктовки никога не се записват в историята. Проверка на всеки 5 секунди предупреждава и с "Dictation paused: secure input on (<App>)", докато защитеното въвеждане остава включено.

Загретият микрофон

Микрофонният вход се включва при първата ви диктовка и след това остава активен, докато приложението работи, затова индикаторът за микрофон в macOS остава включен след първата употреба. В началото на всяко изказване се добавя плъзгащ буфер от 500 ms. Първата диктовка в дадена сесия пак може да плати забавянето при стартиране на входа, а думи, изречени преди този буфер от 500 ms, пак могат да се отрежат. Звукът се преобразува към 16 kHz моно, а смяна на устройството се засича в рамките на секунда.