Aller au contenu de la documentation
Keebye Docs

Installation et autorisations

Configuration requise, la fenêtre d'onboarding, chaque autorisation demandée par Keebye, les mises à jour et l'emplacement des modèles.

Keebye est livré sous forme de DMG signé et notarisé pour les Mac Apple Silicon. Cette page liste ce dont l'app a besoin sur votre Mac et à quoi sert chaque autorisation.

Configuration requise

  • macOS 11.0 ou une version plus récente.
  • Un Mac Apple Silicon. La version publiée est compilée pour arm64 uniquement.
  • De la place pour le modèle vocal par défaut : environ 670 MB sur le disque, téléchargés une seule fois.

La fenêtre d'onboarding

La fenêtre "Welcome to Keebye" affiche cinq étapes. "Finish unlocks once the model is downloaded and both permissions are granted." La même fenêtre se rouvre plus tard comme surface de réparation si une autorisation vient à manquer, par exemple après une mise à jour.

  1. Téléchargement du modèle vocal — environ 670 MB, une seule fois. Cela tourne pendant que vous terminez les étapes ci-dessous.

  2. Accès au micro — appuyez sur "Grant microphone access".

  3. Accès à l'accessibilité — appuyez sur "Open System Settings" et activez Keebye.

  4. Choisir votre touche push-to-talk — Fn / Globe, ⌘ gauche, ⌘ droite, ⌥ gauche ou ⌥ droite.

  5. Essayer — maintenez votre hotkey et parlez dans le champ de test.

Micro

macOS demande : "Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text." Keebye le demande à l'étape 2 de l'onboarding.

Accessibilité

L'accès à l'accessibilité permet à Keebye de surveiller votre hotkey et de coller du texte dans n'importe quelle app. Keebye interroge l'autorisation toutes les 1,5 seconde et réarme le hotkey toutes les 2 secondes une fois qu'elle est accordée : aucun redémarrage n'est nécessaire.

Reconnaissance vocale

Demandée uniquement quand vous sélectionnez le moteur "Native (Apple Speech)". macOS affiche : "Keebye uses on-device speech recognition to turn your dictation into text. Audio stays on your Mac." Tant qu'elle n'est pas accordée, la pilule affiche "Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition".

Mises à jour

À chaque lancement d'une version publiée, Keebye interroge github.com/aiescu/keebye-releases pour voir s'il en existe une plus récente. Si oui, elle est téléchargée, installée en silence, et l'app redémarre. Il n'y a ni demande de confirmation ni entrée de menu pour ça.

Où sont stockés les modèles

Les modèles vivent dans ~/Library/Application Support/com.keebye.app/models/. Les téléchargements sont reprenables, vérifiés en SHA-256 et retentés jusqu'à cinq fois. Seul le modèle par défaut se télécharge automatiquement ; les autres moteurs se téléchargent quand vous appuyez sur "Download model" dans Settings.

  • parakeet-v3 — environ 670 MB (Settings affiche ~640 MB). Le modèle par défaut.
  • parakeet-v3-fp32 — environ 2,55 GB (Settings affiche ~2.4 GB).
  • canary-v2 — environ 1,03 GB (Settings affiche ~1 GB).
  • llm/Qwen_Qwen3-1.7B-Q4_K_M.gguf — environ 1,28 GB, sur activation, utilisé uniquement pour le polissage par LLM local.