Перейти к содержанию документации
Keebye Docs

Установка и разрешения

Системные требования, окно начальной настройки, каждое разрешение, которое запрашивает Keebye, обновления и место хранения моделей.

Keebye поставляется как подписанный и нотаризованный DMG для Mac на Apple Silicon. На этой странице — что приложению нужно от вашего Mac и зачем каждое разрешение.

Требования

  • macOS 11.0 или новее.
  • Mac на Apple Silicon. Релиз собран только под arm64.
  • Место под речевую модель по умолчанию: около 670 MB на диске, загружается один раз.

Окно начальной настройки

Окно "Welcome to Keebye" показывает пять шагов. "Finish unlocks once the model is downloaded and both permissions are granted." — кнопка Finish станет доступной, когда модель загружена и оба разрешения выданы. Это же окно открывается снова как средство восстановления, если разрешение пропало — например, после обновления.

  1. Загрузка речевой модели — около 670 MB, один раз. Идёт, пока вы проходите шаги ниже.

  2. Доступ к микрофону — нажмите "Grant microphone access".

  3. Универсальный доступ — нажмите "Open System Settings" и включите Keebye.

  4. Выбор клавиши push-to-talk — Fn / Globe, левый ⌘, правый ⌘, левый ⌥ или правый ⌥.

  5. Проба — зажмите горячую клавишу и скажите что-нибудь в тестовое поле.

Микрофон

macOS спрашивает: "Keebye listens to your microphone only while you hold your dictation hotkey, to turn your speech into text." — Keebye слушает микрофон только пока вы держите горячую клавишу диктовки, чтобы превратить речь в текст. Разрешение запрашивается на втором шаге начальной настройки.

Универсальный доступ

Универсальный доступ позволяет Keebye отслеживать вашу горячую клавишу и вставлять текст в любое приложение. Keebye проверяет разрешение каждые 1.5 секунды и заново активирует клавишу каждые 2 секунды после выдачи доступа, так что перезапускать приложение не нужно.

Распознавание речи

Запрашивается только при выборе движка "Native (Apple Speech)". macOS показывает: "Keebye uses on-device speech recognition to turn your dictation into text. Audio stays on your Mac." Пока разрешение не выдано, плашка показывает "Speech Recognition permission needed — enable Keebye under System Settings › Privacy & Security › Speech Recognition".

Обновления

При каждом запуске релизной сборки Keebye обращается к github.com/aiescu/keebye-releases за более новой версией. Если она есть, обновление скачивается, устанавливается молча и приложение перезапускается. Никакого запроса и пункта меню для этого нет.

Где хранятся модели

Модели лежат в ~/Library/Application Support/com.keebye.app/models/. Загрузка возобновляемая, проверяется по SHA-256 и повторяется до пяти раз. Автоматически загружается только модель по умолчанию; остальные движки загружаются, когда вы нажимаете "Download model" в окне Settings.

  • parakeet-v3 — около 670 MB (в Settings указано ~640 MB). Модель по умолчанию.
  • parakeet-v3-fp32 — около 2.55 GB (в Settings указано ~2.4 GB).
  • canary-v2 — около 1.03 GB (в Settings указано ~1 GB).
  • llm/Qwen_Qwen3-1.7B-Q4_K_M.gguf — около 1.28 GB, по желанию, используется только для шлифовки локальной LLM.