Lewati ke konten dokumentasi
Keebye Docs

Instalasi dan izin

Persyaratan sistem, jendela onboarding, setiap izin yang diminta Keebye, pembaruan, dan tempat model disimpan.

Keebye dikirim sebagai DMG yang sudah ditandatangani dan dinotarisasi untuk Mac Apple Silicon. Halaman ini mendaftar apa yang dibutuhkannya dari Mac kamu dan fungsi setiap izin.

Persyaratan

  • macOS 11.0 atau lebih baru.
  • Mac Apple Silicon. Rilisnya dibuat hanya untuk arm64.
  • Ruang untuk model suara default: sekitar 670 MB di disk, diunduh sekali.

Jendela onboarding

Jendela "Welcome to Keebye" menampilkan lima langkah. "Finish unlocks once the model is downloaded and both permissions are granted." Jendela yang sama terbuka lagi nanti sebagai layar perbaikan kalau sebuah izin hilang, misalnya setelah pembaruan.

  1. Mengunduh model suara — sekitar 670 MB, sekali saja. Ini berjalan sementara kamu menyelesaikan langkah-langkah di bawah.

  2. Akses Microphone — tekan "Grant microphone access".

  3. Akses Accessibility — tekan "Open System Settings" lalu aktifkan Keebye.

  4. Pilih tombol push-to-talk kamu — Fn / Globe, ⌘ kiri, ⌘ kanan, ⌥ kiri, atau ⌥ kanan.

  5. Coba — tahan hotkey kamu dan bicara ke kolom uji.

Microphone

macOS bertanya: "Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text." Keebye memintanya di langkah 2 onboarding.

Accessibility

Akses Accessibility memungkinkan Keebye memantau hotkey kamu dan menempelkan teks ke aplikasi mana pun. Keebye memeriksa izin ini setiap 1.5 detik dan mengaktifkan ulang hotkey setiap 2 detik setelah izin diberikan, jadi kamu tidak perlu restart.

Speech Recognition

Hanya diminta kalau kamu memilih engine "Native (Apple Speech)". macOS menampilkan: "Keebye uses on-device speech recognition to turn your dictation into text. Audio stays on your Mac." Sampai izin diberikan, pill menampilkan "Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition".

Pembaruan

Setiap kali build rilis dijalankan, Keebye memeriksa github.com/aiescu/keebye-releases untuk versi yang lebih baru. Kalau ada, ia mengunduh, memasang tanpa suara, dan menjalankan ulang aplikasi. Tidak ada prompt dan tidak ada item menu untuk ini.

Tempat model disimpan

Model berada di ~/Library/Application Support/com.keebye.app/models/. Unduhan bisa dilanjutkan, diverifikasi dengan SHA-256, dan dicoba ulang hingga lima kali. Hanya model default yang diunduh otomatis; engine lain diunduh saat kamu menekan "Download model" di Settings.

  • parakeet-v3 — sekitar 670 MB (Settings menampilkan ~640 MB). Model default.
  • parakeet-v3-fp32 — sekitar 2.55 GB (Settings menampilkan ~2.4 GB).
  • canary-v2 — sekitar 1.03 GB (Settings menampilkan ~1 GB).
  • llm/Qwen_Qwen3-1.7B-Q4_K_M.gguf — sekitar 1.28 GB, opsional, hanya dipakai untuk polesan LLM lokal.