For AI agents: full index at https://keebye.com/llms.txt

Přejít na obsah dokumentace
Keebye Docs

Instalace a oprávnění

Systémové požadavky pro Mac a Windows, 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 a jako instalátor (.exe nebo .msi) pro 64bitové Windows 10 a 11. Tato stránka shrnuje, co od vašeho počítače potřebuje a k čemu slouží jednotlivá oprávnění.

Požadavky

  • Mac: macOS 11.0 nebo novější.
  • Mac: Mac s Apple Silicon. Verze pro Mac je sestavená jen pro arm64.
  • Windows: Windows 10 nebo 11 na 64bitovém (x64) PC.
  • Místo pro výchozí model řeči: asi 670 MB na disku, staženo jednorázově.

Instalace na Windows

Spusťte Keebye_<version>_x64-setup.exe, případně .msi, pokud software instalujete z balíčků MSI. Keebye se pak spustí v oznamovací oblasti a otevře stejné okno onboardingu jako na Macu.

Okno onboardingu

Okno "Welcome to Keebye" ukazuje pět kroků. "Finish unlocks once the model is downloaded and both permissions are granted." Na Windows se oba kroky s oprávněními zobrazí jako udělené, takže Finish čeká jen na model. 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í — na Macu stiskněte "Open System Settings" a zapněte Keebye.

  4. Zvolte si klávesu push-to-talk — Fn / Globe, levý ⌘, pravý ⌘, levý ⌥ nebo pravý ⌥ (ekvivalenty pro Windows najdete v článku Začínáme s Keebye).

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

Mikrofon

Na Macu se macOS 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. Na Windows Keebye žádnou výzvu nezobrazuje; Windows udělí přístup k mikrofonu, když začne nahrávání.

Zpřístupnění (Mac)

Na Macu 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. Windows žádné obdobné oprávnění nepotřebují.

Rozpoznávání řeči (Mac)

Na Macu se o něj žádá 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. Kanál aktualizací zatím obsahuje jen verzi pro Mac, takže na Windows aktualizujete stažením novějšího instalátoru z keebye.com.

Kde se ukládají modely

Modely jsou na Macu v ~/Library/Application Support/com.keebye.app/models/ a na Windows v %APPDATA%\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.