Dokümantasyon içeriğine geç
Keebye Docs

Dikte etmek

Bas-konuş tuşu, basılı tutmayla dokunma arasındaki fark, kapsülün gösterdikleri, metnin nasıl eklendiği ve Keebye'ın yazmayı reddettiği yerler.

Bas-konuş tuşuna bas, konuş, bırak. Transkripsiyon, sen tuşu bıraktıktan sonra konuşmanın tamamı üzerinde çalışır ve metin en öndeki uygulamaya eklenir.

Bas-konuş tuşu

Settings › Push-to-talk hotkey: "Hold this key to dictate; release to insert." Değişiklikler anında geçerli olur.

  • Fn / Globe
  • Sol ⌘
  • Sağ ⌘ (varsayılan)
  • Sol ⌥
  • Sağ ⌥

Basılı tut ya da dokun

  • Tuşa basmak kaydı hemen başlatır.
  • 400 ms veya sonrasında bırakmak: bas-konuş. Kayıt durur ve metin eklenir.
  • 400 ms'den önce bırakmak: dokunma. Kayıt açık kalır. İkinci dokunma durdurur ve ekler.
  • Esc, süren bir kaydı iptal eder. Hiçbir şey eklenmez.
  • Tek bir konuşma 300 saniye (5 dakika) ile sınırlıdır; sonra kendiliğinden durur ve eklenir.

Kapsül

Kapsül, birincil ekranının alt ortasında, alt kenardan 96 pt yukarıda duran, her zaman görünür, tıklamaları geçiren küçük bir paneldir. Tüm Spaces'lerde görünür ve odağı asla almaz.

  • Boştayken: bir mikrofon simgesi.
  • Bir model inerken "Downloading speech model… NN%" ya da "Model download failed — reopen Keebye to retry".
  • Dikte sırasında "Listening…" → "Transcribing…" → "Inserting…".
  • Yaklaşık 2,6 saniye görünen kısa mesajlar: "Couldn't insert: <reason>", "Text left on clipboard — paste manually" ya da "Dictation paused: secure input on (<App>)".

Metin nasıl eklenir

Yapıştırma (hızlı), varsayılan: Keebye panonun anlık görüntüsünü alır, transkripti pano yöneticilerinin atladığı geçici bir pano öğesi olarak yazar, ⌘V'yi sentezler ve 250 ms sonra panoyu hâlâ Keebye tutuyorsa önceki panonu geri yükler. "Restore clipboard after paste" varsayılan olarak açıktır.

Terminal.app, iTerm2, Warp, WezTerm ve kitty'de yapıştırma, aralarında 50 ms boşluk olan en çok 2000 baytlık parçalara bölünür.

Yazma (terminaller / SSH / her düzen): Keebye, panoya hiç dokunmadan 16 karakterlik parçalar hâlinde, 4 ms aralıkla Unicode tuş vuruşları gönderir. Klavye düzeninden bağımsızdır; SSH ve tmux üzerinden çalışır. Yazma başarısız olursa metin panoya alınır ve kapsül "Text left on clipboard — paste manually" gösterir.

Parola alanları ve güvenli giriş

Güvenli giriş açıksa ya da odaktaki öğe bir parola alanıysa Keebye panoya hiçbir şey yazmaz ve "Couldn't insert: Secure input is active (<App>) — dictation is blocked" ya da "Couldn't insert: A password field is focused — dictation is blocked" gösterir. Böyle dikteler geçmişe hiç kaydedilmez. 5 saniyelik bir yoklama da güvenli giriş açık kaldığı sürece "Dictation paused: secure input on (<App>)" uyarısını verir.

Sıcak mikrofon

Mikrofon akışı ilk diktende başlar ve sonra uygulama açık olduğu sürece çalışmaya devam eder; bu yüzden ilk kullanımdan sonra macOS mikrofon göstergesi açık kalır. Her konuşmanın başına kayan 500 ms'lik bir ön kayıt eklenir. Bir oturumun ilk diktesi yine akışın başlama gecikmesini ödeyebilir ve o 500 ms'lik tampondan önce söylenen kelimeler yine kırpılabilir. Ses 16 kHz mono'ya yeniden örneklenir ve aygıt değişikliği bir saniye içinde algılanır.