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

Перейти до вмісту документації
Keebye Docs

Диктування

Клавіша push-to-talk, утримання проти натискання, що показує плашка, як вставляється текст і куди Keebye писати відмовиться.

Натисніть клавішу push-to-talk, скажіть фразу, відпустіть. Транскрипція виконується для всієї фрази після відпускання, а текст вставляється в активний застосунок.

Клавіша push-to-talk

Settings › Push-to-talk hotkey: "Hold this key to dictate; release to insert." Зміни застосовуються відразу.

  • Fn / Globe (у Windows — правий Ctrl)
  • лівий ⌘ (у Windows — ліва клавіша Windows)
  • правий ⌘, за замовчуванням (у Windows — права клавіша Windows)
  • лівий ⌥ (у Windows — лівий Alt)
  • правий ⌥ (у Windows — правий Alt)

Утримання чи натискання

  • Натискання клавіші відразу починає запис.
  • Відпускання через 400 ms і більше — режим утримання. Запис зупиняється, текст вставляється.
  • Відпускання раніше ніж через 400 ms — коротке натискання. Запис триває. Друге натискання зупиняє його і вставляє текст.
  • Esc скасовує розпочатий запис. Нічого не вставляється.
  • Одна фраза обмежена 300 секундами (5 хвилин), після чого запис зупиняється і текст вставляється автоматично.

Плашка

Плашка — невелика завжди видима панель, наскрізна для клацань: вона розташована по центру внизу основного екрана, у 96 pt від нижнього краю. На Mac вона показується в усіх 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 (Ctrl+V у Windows) і через 250 ms відновлює попередній буфер, якщо він усе ще належить Keebye. На Mac розшифровка стає тимчасовим елементом, який менеджери буфера пропускають; у Windows відновлюється лише звичайний текст. "Restore clipboard after paste" увімкнено за замовчуванням.

У Terminal.app, iTerm2, Warp, WezTerm і kitty на Mac, а також у Windows Terminal, командному рядку та PowerShell у Windows вставка розбивається на частини не більші за 2000 байт із паузами по 50 ms.

"Typing (terminals / SSH / any layout)": Keebye надсилає Unicode-натискання, не торкаючись буфера обміну; на Mac — по 16 символів з інтервалом 4 ms. Режим не залежить від розкладки і працює через SSH та в tmux. Якщо набір не вдався, текст залишається в буфері обміну, а плашка показує "Text left on clipboard — paste manually".

Поля паролів і захищене введення

На Mac, якщо увімкнене захищене введення або активний елемент — поле пароля, 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>)", поки захищене введення увімкнене.

Прогрітий мікрофон

Потік мікрофона запускається на першому диктуванні й далі працює весь час, поки застосунок запущений, тому системний індикатор використання мікрофона залишається увімкненим після першого використання. До початку кожної фрази додається рухомий буфер 500 ms. Перше диктування за сеанс усе одно може відпрацювати повільніше через запуск потоку, а слова, сказані раніше за цей буфер 500 ms, усе ж можуть обрізатися. Аудіо перераховується в 16 kHz моно, зміна пристрою виявляється протягом секунди.