Ga direct naar de documentatie
Keebye Docs

Installatie en rechten

Systeemvereisten, het onboardingvenster, elk recht dat Keebye vraagt, updates en waar de modellen worden bewaard.

Keebye komt als een ondertekende en genotariseerde DMG voor Apple Silicon-Macs. Deze pagina somt op wat het van je Mac nodig heeft en waar elk recht voor dient.

Vereisten

  • macOS 11.0 of later.
  • Een Apple Silicon-Mac. De release is alleen voor arm64 gebouwd.
  • Ruimte voor het standaard spraakmodel: ongeveer 670 MB op schijf, eenmalig gedownload.

Het onboardingvenster

Het venster "Welcome to Keebye" toont vijf stappen. "Finish unlocks once the model is downloaded and both permissions are granted." Hetzelfde venster opent later opnieuw als reparatiescherm wanneer een recht is weggevallen, bijvoorbeeld na een update.

  1. Het spraakmodel downloaden — ongeveer 670 MB, eenmalig. Dit loopt door terwijl je de stappen hieronder afrondt.

  2. Microfoontoegang — druk op "Grant microphone access".

  3. Toegankelijkheidstoegang — druk op "Open System Settings" en zet Keebye aan.

  4. Kies je push-to-talk-toets — Fn / Globe, linker ⌘, rechter ⌘, linker ⌥ of rechter ⌥.

  5. Probeer het — houd je hotkey ingedrukt en spreek in het testveld.

Microfoon

macOS vraagt: "Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text." Keebye vraagt dit in stap 2 van de onboarding.

Toegankelijkheid

Met toegankelijkheidstoegang kan Keebye je hotkey zien en tekst in elke app plakken. Keebye controleert de toestemming elke 1,5 seconde en activeert de hotkey elke 2 seconden opnieuw zodra die is gegeven, dus je hoeft niet te herstarten.

Spraakherkenning

Wordt alleen gevraagd als je de engine "Native (Apple Speech)" kiest. macOS toont: "Keebye uses on-device speech recognition to turn your dictation into text. Audio stays on your Mac." Tot je toestemming geeft, toont de pil "Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition".

Updates

Bij elke start van een release-build kijkt Keebye op github.com/aiescu/keebye-releases of er een nieuwere versie is. Als die er is, wordt hij gedownload, stil geïnstalleerd en start de app opnieuw. Er komt geen melding en er is geen menu-item voor.

Waar de modellen staan

Modellen staan onder ~/Library/Application Support/com.keebye.app/models/. Downloads kunnen worden hervat, worden met SHA-256 gecontroleerd en tot vijf keer opnieuw geprobeerd. Alleen het standaardmodel wordt automatisch gedownload; andere engines download je door in Settings op "Download model" te drukken.

  • parakeet-v3 — ongeveer 670 MB (Settings toont ~640 MB). De standaard.
  • parakeet-v3-fp32 — ongeveer 2,55 GB (Settings toont ~2.4 GB).
  • canary-v2 — ongeveer 1,03 GB (Settings toont ~1 GB).
  • llm/Qwen_Qwen3-1.7B-Q4_K_M.gguf — ongeveer 1,28 GB, opt-in, alleen gebruikt voor de polijstslag met een lokale LLM.