Нужен Mac с Apple Silicon (M1 или новее) и macOS 14+.

1. Откройте приложение Terminal.
2. Вставьте эту команду и нажмите Enter:

curl -fsSL https://raw.githubusercontent.com/shlgd/SuperDictate/v0.2.48/install.sh | /usr/bin/arch -arm64 /bin/bash

3. В открывшемся SuperDictate нажмите Разрешить для Микрофона, Универсального доступа и Мониторинга ввода.
4. Дождитесь статуса Работает, нажмите правый Command и говорите. Нажмите правый Command ещё раз, чтобы вставить текст.

Установщик сразу скачивает с GitHub и проверяет локальную модель распознавания, показывая прогресс в Terminal. Поэтому после открытия приложения остаётся только выдать три разрешения и дождаться подготовки Neural Engine. Модель занимает около 460 МБ; для установки лучше иметь не менее 2 ГБ свободного места. После установки интернет для диктовки не нужен.

SuperDictate — быстрая локальная диктовка для macOS. Аудио и расшифровка не отправляются в облачный API. Единственное исключение — необязательная AI-чистка текста: она выключена по умолчанию и, если вы её включите, отправляет готовый текст на выбранный вами сервер (см. ниже).

Если в SuperDictate уже есть кнопка Обновить: откройте приложение из папки Applications и нажмите эту кнопку. Приложение само скачает и проверит новую версию, заменит старую и запустится заново.

Если SuperDictate был установлен до появления кнопки обновления: ничего не удаляйте. Откройте Terminal и ещё раз выполните ту же команду:

curl -fsSL https://raw.githubusercontent.com/shlgd/SuperDictate/main/install.sh | /usr/bin/arch -arm64 /bin/bash

Команда заменяет только /Applications/SuperDictate.app. История, настройки и уже загруженная модель остаются на месте. После этого следующие обновления можно устанавливать прямо из приложения.

Начиная с v0.2.45 публичные сборки используют постоянную подпись. При первом переходе со старой версии macOS может попросить выдать разрешения ещё раз. Дальнейшие обновления сохраняют ту же идентичность приложения. Обновления устанавливаются только по вашему действию, не автоматически в фоне.

Последнюю опубликованную версию также всегда можно увидеть на странице GitHub Releases.

Начиная с v0.2.46 в настройках доступен выбор дополнительных моделей: Whisper Large-v3/Turbo, Qwen3-ASR и GigaAM. Parakeet остаётся по умолчанию. С v0.2.48 Python и библиотеки поставляются готовым проверенным архивом: системный Python, Homebrew, pip и инструменты сборки пользователю не нужны. При обновлении с v0.2.47 готовый движок (около 280 МБ) автоматически загружается с GitHub, с прогрессом в панели; полный установщик уже содержит его внутри. Существующие веса сохраняются, готовый движок повторно не скачивается. Дополнительные модели требуют отдельной загрузки весов и проверки качества на вашей речи; пока они скачиваются, можно пользоваться текущей моделью.

• Правый Command — начать диктовку; повторное нажатие завершает запись.
• В настройках можно выбрать, что делает повторное нажатие: просто вставляет текст или вставляет текст и затем нажимает Enter.
• Правый Option + правый Command — альтернативно завершить активную запись. Он выполняет противоположное действие: если основной хоткей нажимает Enter, этот завершит без Enter, и наоборот. Альтернативный хоткей можно выключить.
• Правый Shift + правый Command — открыть или закрыть быструю историю.
• История показывает по 5 записей; стрелки листают до 100 последних транскрипций. Нажатие на запись копирует её и закрывает панель.
• Кнопка импорта аудио в истории принимает один или несколько аудиофайлов, показывает прогресс и сохраняет готовые .txt на Рабочий стол или в выбранную в настройках папку.
• Все три сочетания можно изменить независимо. Поддерживаются одиночные клавиши, функциональные клавиши, обычные сочетания и сочетания только из модификаторов, например Option + Command.
• Левая и правая основные клавиши различаются: сочетание с правым Command не сработает от левого Command.
• Пока открыто окно записи нового сочетания, глобальная диктовка временно приостанавливается. Нажатые клавиши только записывают новый хоткей и ничего не запускают.
• Откройте SuperDictate из Applications, чтобы проверить службу, разрешения и обновления. Настройки открываются кнопкой-шестерёнкой.

Основная панель компактна: в ней видны состояние фоновой службы, недостающие разрешения и доступное обновление. Кнопки управления службой находятся справа от её статуса; при наведении macOS показывает пояснение к каждой кнопке.

Шестерёнка открывает отдельное окно с тремя сочетаниями, поведением завершения, выбором микрофона, папкой экспорта аудиофайлов, размером капсулы, цветами и фоном индикатора. Переключатель RU / EN мгновенно меняет язык обеих панелей. Изменения сначала остаются черновиком; кнопка Сохранить и перезапустить применяет их вместе и перезапускает только фоновую службу. История и модель при этом не удаляются.

Панель можно полностью закрыть. Отдельная фоновая служба продолжит работать и автоматически запустится после следующего входа в macOS.

По умолчанию диктовка полностью локальна. Дополнительно можно включить AI-чистку: после распознавания текст отправляется на OpenAI-совместимый сервер, который исправляет пунктуацию, грамматику и очевидные ошибки распознавания. Функция выключена по умолчанию и работает только с вашим собственным ключом.

Настройка:

1. Получите ключ у любого OpenAI-совместимого провайдера (по умолчанию — Groq, бесплатный ключ на console.groq.com; также подойдут OpenAI, DeepSeek, OpenCode Zen, OpenRouter).
2. Откройте Настройки → раздел AI-чистка текста, вставьте ключ и нажмите Сохранить ключ. Ключ хранится только в Связке ключей macOS.
3. При необходимости измените базовый URL и модель (по умолчанию — https://api.groq.com/openai/v1 и openai/gpt-oss-20b), включите переключатель и нажмите Сохранить. Для Groq запрос настроен на низкую задержку. Кнопка Проверить подключение проверяет ключ, адрес и доступность выбранной модели.

Важно: продиктованный текст отправляется выбранному провайдеру, и бесплатные тарифы некоторых провайдеров (например, OpenCode Zen) могут сохранять его для улучшения модели — перед личной диктовкой проверьте политику данных. Если сервер недоступен или ответил ошибкой, вставляется исходный локальный текст — диктовка никогда не теряется.

macOS не разрешает приложению выдать их самому:

• Microphone — записывать голос во время активной диктовки.
• Accessibility — находить активное поле и вставлять готовый текст.
• Input Monitoring — видеть глобальную горячую клавишу.

Если после выдачи разрешений статус не стал Ready, откройте SuperDictate и нажмите Restart у фоновой службы. Если приложение не появилось в системном списке, нажмите Try Again у соответствующего разрешения.

Установщик:

1. Загружает SuperDictate.zip и закреплённую модель SuperDictate-Model-v3.zip из GitHub Releases.
2. Показывает прогресс обеих загрузок прямо в Terminal. Если проверенная модель уже установлена, повторно её не скачивает.
3. Проверяет закреплённые SHA-256, содержимое модели, версию, bundle ID, архитектуру arm64, подпись и microphone-entitlements.
4. Атомарно устанавливает модель, безопасно заменяет /Applications/SuperDictate.app и открывает панель.

Xcode и Command Line Tools для обычной установки не нужны. История, настройки и уже загруженная модель при обновлении сохраняются.

• Иконка в меню-баре: показывает компактную аудиоволну в верхней строке macOS. Нажатие открывает панель управления. По умолчанию выключено.
• Диктовка при удержании: удерживайте основной хоткей, пока говорите, затем отпустите для распознавания и вставки. По умолчанию выключено: запись начинается и завершается отдельными нажатиями.
• Действие «При отпускании» (или «Повторное нажатие») позволяет выбрать вставку с Enter или без него.
• Кнопки «Отменить» и «Сохранить» закреплены внизу окна и всегда видны при прокрутке. Настройки применяются после сохранения без перезапуска модели.

1. Откройте SuperDictate из папки Applications.
2. В нижней строке панель сама покажет новую версию.
3. Нажмите Обновить.

Архив скачается, пройдёт проверку SHA-256, bundle ID, версии и подписи, после чего приложение заменит себя и откроется заново. История, настройки и модель сохраняются. Предыдущая версия автоматически восстанавливается при ошибке.

В этих версиях кнопки ещё нет. Один раз повторите установочную команду ниже. Она обновит приложение без удаления истории, настроек и модели. Все следующие обновления можно будет устанавливать кнопкой в панели.

Эта же команда остаётся запасным способом для любой версии:

curl -fsSL https://raw.githubusercontent.com/shlgd/SuperDictate/v0.2.48/install.sh | /usr/bin/arch -arm64 /bin/bash

Приложение само не устанавливает обновления в фоне: запуск обновления всегда нужно подтвердить кнопкой.

Команда скачает открытый исходный код, соберёт его локально и установит результат в /Applications:

curl -fsSL https://raw.githubusercontent.com/shlgd/SuperDictate/v0.2.48/install.sh | SUPERDICTATE_BUILD_FROM_SOURCE=1 /usr/bin/arch -arm64 /bin/bash

Понадобятся бесплатные Apple Command Line Tools. Если их нет, установщик откроет стандартный диалог установки; после его завершения запустите команду ещё раз. Первая чистая сборка обычно занимает несколько минут.

По умолчанию сборка из исходников скачивает точный коммит исходного кода релиза и проверяет его через GitHub. Для разработки можно передать свои SUPERDICTATE_REF и SUPERDICTATE_SOURCE_COMMIT; без совпадения коммита установщик не запустит скачанный scripts/build-app.sh.

xcode-select --install
git clone https://github.com/shlgd/SuperDictate.git
cd SuperDictate
swift run -c debug --package-path swift Parakey --self-test all
./scripts/build-app.sh ./dist/SuperDictate.app
open ./dist/SuperDictate.app

По умолчанию локальная сборка подписывается ad-hoc. Чтобы использовать свой сертификат, передайте его имя:

SIGN_IDENTITY="Apple Development: Your Name (TEAMID)" ./scripts/build-app.sh ./dist/SuperDictate.app

Для следующих публичных релизов используется bash scripts/package-release.sh с постоянной подписью издателя, без автоматического отката к ad-hoc. Подпись, сохранение разрешений и проверка обновлений. Разовая повторная выдача прав при переходе со старой подписи может потребоваться; сама подпись не заменяет разрешение macOS на первый запуск.

Не перемещайте и не удаляйте dist/SuperDictate.app, пока фоновая служба запущена из этой сборки. Для обычного использования предпочтительнее команда с SUPERDICTATE_BUILD_FROM_SOURCE=1, которая ставит приложение в /Applications.

bash -n install.sh uninstall.sh scripts/build-app.sh
plutil -lint swift/Info.plist entitlements.plist
swift run -c debug --package-path swift Parakey --self-test all
./scripts/build-app.sh ./dist/SuperDictate.app
codesign --verify --deep --strict ./dist/SuperDictate.app

GitHub Actions повторяет самотесты, собирает bundle, прогоняет установщик на чистом macOS runner и проверяет удаление.

• Поддерживаются только Apple Silicon и macOS 14 или новее. Intel Mac, Windows и Linux пока не поддерживаются.
• Публичная сборка подписана ad-hoc и не нотарифицирована Apple. Установка через команду выше проверена, но ZIP, скачанный вручную через браузер, может вызвать предупреждение Gatekeeper.
• Из-за отсутствия стабильной Developer ID подписи macOS иногда повторно запрашивает разрешения после обновления. Нотаризация требует платного аккаунта Apple Developer.
• Установка требует доступа к GitHub Releases, откуда одной командой загружаются приложение и модель. Первый запуск модели уже не зависит от Hugging Face. Панель проверяет обновления при открытии; фоновая автопроверка, если включена, обращается к публичному GitHub API раз в шесть часов.
• Одна запись автоматически завершается через 20 минут. При аварийном завершении незаконченная запись сохраняется для восстановления истории.
• Защищённые поля паролей и приложения, которые скрывают Accessibility-данные, могут не отдавать координаты каретки. Это влияет на положение анимации, но не всегда мешает вставке текста.
• Ориентир по ресурсам на текущей сборке: около 460 МБ на диске для модели, примерно 100–150 МБ памяти в простое и до 500 МБ во время загрузки/работы модели. Значения зависят от macOS и длины записи.

• История и настройки: ~/Library/Application Support/SuperDictate.
• Модель FluidAudio: ~/Library/Application Support/FluidAudio/Models.
• LaunchAgent: ~/Library/LaunchAgents/com.local.superdictate.agent.plist.
• Логи: ~/Library/Logs/SuperDictate*.
• Ключ API для AI-чистки: только в Связке ключей macOS.
• Аналитики, аккаунтов и телеметрии нет.

Подробнее: PRIVACY.md.

curl -fsSL https://raw.githubusercontent.com/shlgd/SuperDictate/v0.2.48/uninstall.sh | bash

Приложение и фоновая служба удаляются. История, настройки и модель сохраняются, чтобы случайно не потерять данные и не загружать модель повторно.

SuperDictate основан на открытом проекте Parakey Richard Courtman. Исходный и изменённый код распространяется по лицензии MIT. См. LICENSE и NOTICE.md. Атрибуция модели, распространяемой отдельным release asset, находится в MODEL_ATTRIBUTION.md.