Диктування

Натисніть клавішу 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 хвилин), після чого запис зупиняється і текст вставляється автоматично.

Плашка

Плашка — невелика завжди видима панель, наскрізна для клацань: вона розташована по центру внизу основного екрана, у 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 моно, зміна пристрою виявляється протягом секунди.