Zum Dokumentationsinhalt springen
Keebye Docs

Installation und Berechtigungen

Systemanforderungen, das Onboarding-Fenster, jede Berechtigung, die Keebye anfragt, Updates und der Speicherort der Modelle.

Keebye wird als signiertes und notarisiertes DMG für Macs mit Apple Silicon ausgeliefert. Diese Seite listet auf, was die App von Ihrem Mac braucht und wozu jede Berechtigung dient.

Anforderungen

  • macOS 11.0 oder neuer.
  • Ein Mac mit Apple Silicon. Das Release ist ausschließlich für arm64 gebaut.
  • Platz für das Standard-Sprachmodell: etwa 670 MB auf der Festplatte, einmalig geladen.

Das Onboarding-Fenster

Das Fenster "Welcome to Keebye" zeigt fünf Schritte. "Finish unlocks once the model is downloaded and both permissions are granted." Dasselbe Fenster öffnet sich später wieder als Reparaturfläche, wenn eine Berechtigung fehlt, zum Beispiel nach einem Update.

  1. Das Sprachmodell wird heruntergeladen — etwa 670 MB, einmalig. Das läuft, während Sie die Schritte darunter erledigen.

  2. Mikrofon-Zugriff — drücken Sie "Grant microphone access".

  3. Bedienungshilfen-Zugriff — drücken Sie "Open System Settings" und schalten Sie Keebye ein.

  4. Push-to-Talk-Taste wählen — Fn / Globe, linke ⌘, rechte ⌘, linke ⌥ oder rechte ⌥.

  5. Ausprobieren — halten Sie Ihren Hotkey und sprechen Sie in das Testfeld.

Mikrofon

macOS fragt: "Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text." Keebye fordert das in Onboarding-Schritt 2 an.

Bedienungshilfen

Der Bedienungshilfen-Zugriff erlaubt Keebye, Ihren Hotkey zu überwachen und Text in jede App einzufügen. Keebye prüft die Freigabe alle 1,5 Sekunden und aktiviert den Hotkey nach der Erteilung alle 2 Sekunden neu, sodass kein Neustart nötig ist.

Spracherkennung

Wird nur abgefragt, wenn Sie die Engine "Native (Apple Speech)" wählen. macOS zeigt: "Keebye uses on-device speech recognition to turn your dictation into text. Audio stays on your Mac." Bis die Freigabe erteilt ist, zeigt die Pille "Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition".

Updates

Bei jedem Start eines Release-Builds prüft Keebye github.com/aiescu/keebye-releases auf eine neuere Version. Gibt es eine, wird sie geladen, still installiert und die App neu gestartet. Es gibt dafür keine Abfrage und keinen Menüpunkt.

Wo die Modelle liegen

Die Modelle liegen unter ~/Library/Application Support/com.keebye.app/models/. Downloads sind fortsetzbar, werden mit SHA-256 geprüft und bis zu fünfmal wiederholt. Nur das Standardmodell wird automatisch geladen; andere Engines laden, wenn Sie in Settings "Download model" drücken.

  • parakeet-v3 — etwa 670 MB (Settings zeigt ~640 MB). Der Standard.
  • parakeet-v3-fp32 — etwa 2,55 GB (Settings zeigt ~2.4 GB).
  • canary-v2 — etwa 1,03 GB (Settings zeigt ~1 GB).
  • llm/Qwen_Qwen3-1.7B-Q4_K_M.gguf — etwa 1,28 GB, opt-in, nur für den lokalen LLM-Feinschliff.