Lewati ke konten dokumentasi
Keebye Docs

Mendikte

Tombol push-to-talk, tahan versus ketuk, apa yang ditampilkan pill, cara teks disisipkan, dan di mana Keebye menolak menulis.

Tekan tombol push-to-talk kamu, bicara, lepas. Transkripsi dijalankan atas seluruh ucapan setelah kamu melepas tombol, dan teksnya disisipkan ke aplikasi mana pun yang sedang paling depan.

Tombol push-to-talk

Settings › Push-to-talk hotkey: "Hold this key to dictate; release to insert." Perubahan langsung berlaku.

  • Fn / Globe
  • ⌘ kiri
  • ⌘ kanan (default)
  • ⌥ kiri
  • ⌥ kanan

Tahan atau ketuk

  • Menekan tombol langsung memulai perekaman.
  • Lepas setelah 400 ms atau lebih: tahan-untuk-bicara. Perekaman berhenti dan teksnya disisipkan.
  • Lepas sebelum 400 ms: ketukan. Perekaman tetap berjalan. Ketukan kedua menghentikannya dan menyisipkan teks.
  • Esc membatalkan perekaman yang sedang berjalan. Tidak ada yang disisipkan.
  • Satu ucapan dibatasi 300 detik (5 menit), setelah itu perekaman berhenti dan teksnya disisipkan otomatis.

Pill

Pill adalah panel kecil yang selalu terlihat dan bisa ditembus klik, berada di bawah-tengah layar utamamu, 96 pt di atas tepi bawah. Ia muncul di semua Space dan tidak pernah mengambil fokus.

  • Diam: ikon mikrofon.
  • "Downloading speech model… NN%" saat sebuah model diunduh, atau "Model download failed — reopen Keebye to retry".
  • "Listening…" → "Transcribing…" → "Inserting…" selama dikte berlangsung.
  • Pesan singkat selama sekitar 2.6 detik: "Couldn't insert: <reason>", "Text left on clipboard — paste manually", atau "Dictation paused: secure input on (<App>)".

Cara teks disisipkan

Paste (fast), mode default: Keebye menyimpan snapshot clipboard kamu, menulis transkrip sebagai item pasteboard sementara yang dilewati oleh clipboard manager, mensintesis ⌘V, dan setelah 250 ms memulihkan clipboard sebelumnya kalau Keebye masih memiliki pasteboard itu. "Restore clipboard after paste" aktif secara default.

Di Terminal.app, iTerm2, Warp, WezTerm, dan kitty, paste dipecah menjadi potongan maksimal 2000 byte dengan jeda 50 ms.

Typing (terminals / SSH / any layout): Keebye mengirim ketukan tombol Unicode dalam potongan 16 karakter, berjarak 4 ms, tanpa menyentuh clipboard. Ia tidak bergantung pada tata letak keyboard dan bekerja lewat SSH maupun tmux. Kalau pengetikan gagal, teksnya masuk ke clipboard dan pill menampilkan "Text left on clipboard — paste manually".

Kolom kata sandi dan input aman

Kalau input aman sedang aktif, atau elemen yang fokus adalah kolom kata sandi, Keebye tidak menulis apa pun ke clipboard dan menampilkan "Couldn't insert: Secure input is active (<App>) — dictation is blocked" atau "Couldn't insert: A password field is focused — dictation is blocked". Dikte semacam itu tidak pernah disimpan ke riwayat. Pemeriksaan setiap 5 detik juga memperingatkan "Dictation paused: secure input on (<App>)" selama input aman tetap aktif.

Mikrofon yang tetap hangat

Stream mikrofon dimulai pada dikte pertamamu lalu terus berjalan sepanjang aplikasi hidup, jadi indikator mikrofon macOS tetap menyala setelah pemakaian pertama. Pre-roll bergulir 500 ms ditambahkan di awal setiap ucapan. Dikte pertama dalam satu sesi masih bisa terkena latensi awal stream, dan kata yang diucapkan sebelum buffer 500 ms itu masih bisa terpotong. Audio di-resample ke 16 kHz mono dan pergantian perangkat terdeteksi dalam satu detik.