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

Kurulum ve izinler

Sistem gereksinimleri, kurulum penceresi, Keebye'ın istediği her izin, güncellemeler ve modellerin nerede tutulduğu.

Keebye, Apple Silicon Mac'ler için imzalı ve notarize edilmiş bir DMG olarak dağıtılır. Bu sayfa Mac'inden ne istediğini ve her iznin ne yaptığını listeler.

Gereksinimler

  • macOS 11.0 veya sonrası.
  • Apple Silicon bir Mac. Sürüm yalnızca arm64 için derlenir.
  • Varsayılan konuşma modeli için yer: diskte yaklaşık 670 MB, bir kez indirilir.

Kurulum penceresi

"Welcome to Keebye" penceresi beş adım gösterir. "Finish", model indikten ve iki izin de verildikten sonra açılır. Aynı pencere, örneğin bir güncellemeden sonra bir izin kaybolursa onarım ekranı olarak yeniden açılır.

  1. Konuşma modeli iniyor — yaklaşık 670 MB, bir kez. Bu, aşağıdaki adımları tamamlarken çalışır.

  2. Mikrofon izni — "Grant microphone access" düğmesine bas.

  3. Erişilebilirlik izni — "Open System Settings" düğmesine bas ve Keebye'ı aç.

  4. Bas-konuş tuşunu seç — Fn / Globe, Sol ⌘, Sağ ⌘, Sol ⌥ ya da Sağ ⌥.

  5. Dene — hotkey'i basılı tut ve test alanına konuş.

Mikrofon

macOS şunu sorar: "Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text." Keebye bunu kurulumun 2. adımında ister.

Erişilebilirlik

Erişilebilirlik izni, Keebye'ın hotkey'ini izlemesini ve metni herhangi bir uygulamaya yapıştırmasını sağlar. Keebye izni her 1,5 saniyede yoklar ve izin verildikten sonra hotkey'i her 2 saniyede yeniden devreye alır; bu yüzden yeniden başlatmana gerek yoktur.

Konuşma Tanıma

Yalnızca "Native (Apple Speech)" motorunu seçtiğinde istenir. macOS şunu gösterir: "Keebye uses on-device speech recognition to turn your dictation into text. Audio stays on your Mac." İzin verilene kadar kapsül "Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition" gösterir.

Güncellemeler

Yayın sürümü her açılışta github.com/aiescu/keebye-releases adresinde daha yeni bir sürüm olup olmadığına bakar. Varsa indirir, sessizce kurar ve uygulamayı yeniden başlatır. Bunun için ne bir istem ne de bir menü öğesi vardır.

Modeller nerede tutulur

Modeller ~/Library/Application Support/com.keebye.app/models/ altında durur. İndirmeler kaldığı yerden devam eder, SHA-256 ile doğrulanır ve beş kez yeniden denenir. Yalnızca varsayılan model kendiliğinden iner; diğer motorlar, Settings'te "Download model" düğmesine bastığında iner.

  • parakeet-v3 — yaklaşık 670 MB (Settings ~640 MB gösterir). Varsayılan.
  • parakeet-v3-fp32 — yaklaşık 2,55 GB (Settings ~2.4 GB gösterir).
  • canary-v2 — yaklaşık 1,03 GB (Settings ~1 GB gösterir).
  • llm/Qwen_Qwen3-1.7B-Q4_K_M.gguf — yaklaşık 1,28 GB, isteğe bağlı, yalnızca yerel LLM rötuşu için kullanılır.