Перейти к основному содержимому
macOS

Установка на macOS

Speech Dock для Apple Silicon (M1/M2/M3) и Intel Mac. Metal GPU acceleration, нативный NSPanel overlay, native CGEvent для глобальных хоткеев.

Один API, но нужны разрешения

Как и в Windows, в macOS один системный способ вставить текст в активное окно — не нужно выбирать между X11 и Wayland, как на Linux. Но в отличие от Windows, macOS требует явно выданных разрешений (Accessibility, Input Monitoring) — без них автовставка и горячие клавиши не заработают. Как их выдать — чуть ниже на этой странице.

Выберите архитектуру

Проверить архитектуру: меню Apple → Об этом Mac → раздел «Chip» (M1/M2/M3 = Apple Silicon, Intel Core = Intel).

Apple Silicon

M1, M2, M3 и новее. Metal GPU acceleration, native arm64 binary.

Скачать DMG (arm64)

Intel Mac

Intel Core i5/i7/i9. Поддерживаются macOS 11.0 Big Sur или новее.

Скачать DMG (x64)

Системные требования и компромиссы.

Для локальной обработки важны память, диск и первый запуск. GPU не обязателен, но может ускорять обработку на поддерживаемых системах.

macOS

  • ОСmacOS 11.0 Big Sur или новее
  • АрхитектураApple Silicon · Intel x86_64
  • RAM8 GB минимум · 16 GB рекомендовано
  • ДискНужные компоненты скачиваются при первой настройке; держите несколько GB свободного места
  • GPUНе обязателен; Metal может использоваться на поддерживаемых Mac
  • СетьНужна для скачивания необходимых компонентов, обновлений, оплаты и лицензии
  • ИнтеграцияAppleScript, Accessibility API

Установка

  1. 1

    Скачайте DMG

    Файл откроется автоматически в Finder.

  2. 2

    Перетащите Speech Dock.app в папку Applications

    Стандартный drag-and-drop install для macOS.

  3. 3

    При первом запуске Gatekeeper может заблокировать приложение

    Это нормальное поведение macOS для приложений вне App Store. См. раздел Gatekeeper ниже.

  4. 4

    Дайте разрешения Microphone и Accessibility

    См. разделы ниже.

Gatekeeper: разрешить запуск

Speech Dock подписан Apple Developer ID и нотаризован, поэтому в большинстве случаев запускается без предупреждений. Если вы видите диалог «приложение не может быть открыто» — выполните:

Способ 1 (Recommended)

  1. В Finder откройте папку Applications
  2. Удерживая Control, кликните на Speech Dock.app
  3. В контекстном меню выберите «Открыть»
  4. В диалоге нажмите «Открыть» ещё раз

Способ 2 (через Настройки)

  1. Запустите приложение — появится предупреждение, нажмите «Отмена»
  2. Откройте Системные настройки → Конфиденциальность и безопасность
  3. В нижней части появится сообщение «Speech Dock был заблокирован»
  4. Нажмите «Открыть всё равно»

После одного успешного запуска macOS запомнит разрешение и больше не будет спрашивать.

Accessibility (для глобальных хоткеев)

macOS требует разрешение Accessibility для:

  • Глобальных хоткеев (запуск/остановка диктовки из любого приложения через CGEventTap)
  • Auto-paste текста в активное окно (Cmd+V через CGEvent)

Onboarding wizard приложения попросит разрешение автоматически. Если нужно настроить вручную:

  1. Системные настройки → Конфиденциальность и безопасность → Универсальный доступ
  2. Найдите Speech Dock в списке (если нет — нажмите «+» и добавьте из Applications)
  3. Включите переключатель
  4. Перезапустите Speech Dock

Microphone

При первом запуске Speech Dock запросит разрешение на доступ к микрофону. Если случайно отказали — Системные настройки → Конфиденциальность → Микрофон → включить переключатель напротив Speech Dock.

Troubleshooting

Это сообщение Gatekeeper для приложений вне App Store. См. раздел Gatekeeper выше (Способ 1 или Способ 2). После одного успешного запуска предупреждение исчезнет.

Чаще всего — не выдано разрешение Accessibility. Откройте Системные настройки → Конфиденциальность → Универсальный доступ и убедитесь что переключатель напротив Speech Dock включён. После изменения разрешения перезапустите приложение.

Auto-paste также требует Accessibility (тот же переключатель). Если разрешение выдано, но всё ещё не работает — попробуйте:

  • Перезапустить приложение полностью (Cmd+Q, затем заново)
  • В Системных настройках выключить и снова включить переключатель Accessibility
  • Перезагрузить Mac (иногда CGEventTap кэширует устаревший state)

Metal acceleration работает на всех Apple Silicon Mac автоматически. На Intel Mac Metal недоступен для ML inference — приложение использует CPU. Это ожидаемое поведение.

Если вы на Apple Silicon, но приложение работает медленно — откройте Activity Monitor и проверьте, что в столбце «% GPU» Speech Dock использует ресурсы. Если 0% — возможно, ggml-metal.metallib не подгрузился; напишите на support.

Иногда macOS quarantine flag устанавливается некорректно. Очистите его через Terminal:

Terminal
bash
xattr -dr com.apple.quarantine /Applications/"Speech Dock.app"

Готовы попробовать? Free версия — без регистрации.

Документация