Перейти до вмісту документації
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.