Přejít na obsah dokumentace
Keebye Docs

Instalace a oprávnění

Systémové požadavky, okno onboardingu, jednotlivá oprávnění, o která Keebye žádá, aktualizace a kde se ukládají modely.

Keebye se distribuuje jako podepsaný a notarizovaný DMG pro Macy s Apple Silicon. Tato stránka shrnuje, co od vašeho Macu potřebuje a k čemu slouží jednotlivá oprávnění.

Požadavky

  • macOS 11.0 nebo novější.
  • Mac s Apple Silicon. Vydaná verze je sestavená jen pro arm64.
  • Místo pro výchozí model řeči: asi 670 MB na disku, staženo jednorázově.

Okno onboardingu

Okno "Welcome to Keebye" ukazuje pět kroků. "Finish unlocks once the model is downloaded and both permissions are granted." Stejné okno se později znovu otevře jako opravná obrazovka, pokud některé oprávnění zmizí, například po aktualizaci.

  1. Stahování modelu řeči — asi 670 MB, jednorázově. Běží, zatímco dokončujete kroky níže.

  2. Přístup k mikrofonu — stiskněte "Grant microphone access".

  3. Přístup ke Zpřístupnění — stiskněte "Open System Settings" a zapněte Keebye.

  4. Zvolte si klávesu push-to-talk — Fn / Globe, levý ⌘, pravý ⌘, levý ⌥ nebo pravý ⌥.

  5. Vyzkoušejte si to — podržte klávesu a namluvte něco do testovacího pole.

Mikrofon

macOS se ptá: "Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text." Keebye o toto oprávnění žádá ve druhém kroku onboardingu.

Zpřístupnění

Přístup ke Zpřístupnění umožňuje Keebye sledovat vaši klávesu a vkládat text do libovolné aplikace. Keebye stav oprávnění kontroluje každých 1,5 sekundy a po udělení znovu aktivuje klávesu každé 2 sekundy, takže restart není potřeba.

Rozpoznávání řeči

Žádá se o něj jen tehdy, když zvolíte engine "Native (Apple Speech)". macOS zobrazí: "Keebye uses on-device speech recognition to turn your dictation into text. Audio stays on your Mac." Dokud oprávnění neudělíte, pilulka ukazuje "Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition".

Aktualizace

Při každém spuštění vydané verze Keebye zkontroluje github.com/aiescu/keebye-releases, jestli existuje novější verze. Pokud ano, stáhne ji, tiše nainstaluje a aplikaci restartuje. Není u toho žádná výzva ani položka v nabídce.

Kde se ukládají modely

Modely jsou v ~/Library/Application Support/com.keebye.app/models/. Stahování lze obnovit, ověřuje se přes SHA-256 a opakuje se až pětkrát. Automaticky se stahuje jen výchozí model; ostatní enginy se stáhnou, když v Nastavení stisknete "Download model".

  • parakeet-v3 — asi 670 MB (Nastavení uvádí ~640 MB). Výchozí.
  • parakeet-v3-fp32 — asi 2,55 GB (Nastavení uvádí ~2.4 GB).
  • canary-v2 — asi 1,03 GB (Nastavení uvádí ~1 GB).
  • llm/Qwen_Qwen3-1.7B-Q4_K_M.gguf — asi 1,28 GB, volitelný, používá se jen pro doleštění lokálním LLM.