Przejdź do treści dokumentacji
Keebye Docs

Dyktowanie

Klawisz push-to-talk, przytrzymanie a stuknięcie, co pokazuje pigułka, jak wstawiany jest tekst i gdzie Keebye odmawia pisania.

Naciśnij klawisz push-to-talk, powiedz swoje, puść. Transkrypcja przetwarza całą wypowiedź po puszczeniu klawisza, a tekst ląduje w aplikacji, która jest na wierzchu.

Klawisz push-to-talk

Settings › Push-to-talk hotkey: "Hold this key to dictate; release to insert." Zmiany działają od razu.

  • Fn / Globe
  • Lewy ⌘
  • Prawy ⌘ (domyślnie)
  • Lewy ⌥
  • Prawy ⌥

Przytrzymanie albo stuknięcie

  • Naciśnięcie klawisza natychmiast rozpoczyna nagrywanie.
  • Puszczenie po 400 ms lub później: przytrzymanie. Nagrywanie się kończy, a tekst zostaje wstawiony.
  • Puszczenie przed 400 ms: stuknięcie. Nagrywanie trwa dalej. Drugie stuknięcie kończy je i wstawia tekst.
  • Esc anuluje trwające nagrywanie. Nic nie zostaje wstawione.
  • Jedna wypowiedź jest ograniczona do 300 sekund (5 minut) — potem nagrywanie kończy się i wstawia tekst automatycznie.

Pigułka

Pigułka to mały, zawsze widoczny panel na dole ekranu głównego, 96 pt nad dolną krawędzią, przez który kliknięcia przechodzą dalej. Pojawia się na wszystkich przestrzeniach Spaces i nigdy nie przejmuje fokusu.

  • W spoczynku: ikona mikrofonu.
  • "Downloading speech model… NN%" podczas pobierania modelu albo "Model download failed — reopen Keebye to retry".
  • "Listening…" → "Transcribing…" → "Inserting…" w trakcie dyktowania.
  • Krótkie komunikaty na około 2,6 sekundy: "Couldn't insert: <reason>", "Text left on clipboard — paste manually" albo "Dictation paused: secure input on (<App>)".

Jak wstawiany jest tekst

Paste (fast), tryb domyślny: Keebye zapisuje kopię Twojego schowka, umieszcza transkrypcję jako tymczasowy element schowka, który menedżery schowka pomijają, symuluje ⌘V, a po 250 ms przywraca poprzednią zawartość schowka, jeśli nadal należy do Keebye. "Restore clipboard after paste" jest domyślnie włączone.

W Terminal.app, iTerm2, Warp, WezTerm i kitty wklejanie jest dzielone na porcje po maksymalnie 2000 bytes z 50 ms przerwy.

Typing (terminals / SSH / any layout): Keebye wysyła znaki Unicode jako naciśnięcia klawiszy, porcjami po 16 znaków, co 4 ms, nie ruszając schowka. Nie zależy to od układu klawiatury i działa przez SSH oraz w tmux. Jeśli wpisywanie się nie uda, tekst trafia do schowka, a pigułka pokazuje "Text left on clipboard — paste manually".

Pola haseł i zabezpieczone wprowadzanie

Jeśli zabezpieczone wprowadzanie jest włączone albo fokus ma pole hasła, Keebye nie zapisuje niczego do schowka i pokazuje "Couldn't insert: Secure input is active (<App>) — dictation is blocked" albo "Couldn't insert: A password field is focused — dictation is blocked". Takie dyktowania nigdy nie trafiają do historii. Sprawdzanie co 5 sekund dodatkowo ostrzega komunikatem "Dictation paused: secure input on (<App>)", dopóki zabezpieczone wprowadzanie jest włączone.

Ciepły mikrofon

Strumień mikrofonu startuje przy pierwszym dyktowaniu i potem działa przez cały czas pracy aplikacji, dlatego wskaźnik mikrofonu w macOS świeci po pierwszym użyciu. Na początek każdej wypowiedzi dokładany jest przesuwny bufor 500 ms. Pierwsze dyktowanie w sesji może wciąż zapłacić za start strumienia, a słowa wypowiedziane przed tym buforem 500 ms nadal mogą się uciąć. Dźwięk jest przepróbkowany do 16 kHz mono, a zmiana urządzenia jest wykrywana w ciągu sekundy.