← Назад к документации

Руководство по установке на macOS

Это руководство поможет вам установить Sokuji на системы macOS. Sokuji доступен как подписанный и нотаризованный установщик .pkg, который включает виртуальный аудиодрайвер для расширенных возможностей обработки звука.

Скачать для macOS

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

  • macOS 13 (Ventura) или новее (начиная с v0.42.2; на macOS 12 продолжайте пользоваться v0.42.1)
  • Процессор Apple Silicon (M1/M2/M3/M4) или Intel (x86_64)
  • Минимум 4 ГБ оперативной памяти (рекомендуется 8 ГБ)
  • 200 МБ свободного дискового пространства
  • Права администратора (необходимы для установки виртуального аудиодрайвера)
  • Подключение к интернету для служб перевода с ИИ
  • Микрофон и динамики/наушники

Шаги установки

Шаг 1: Скачать Sokuji

Посетите официальную страницу релизов на GitHub, чтобы скачать последнюю версию Sokuji для macOS.

Скачать установщик PKG

  • Sokuji-x.x.x-arm64.pkg - Для Mac с Apple Silicon (M1/M2/M3/M4)
  • Sokuji-x.x.x-x64.pkg - Для Mac с Intel
  • Каждый установщик включает приложение Sokuji и виртуальный аудиодрайвер
  • Размер файла примерно 150-200 МБ

Совет: Не уверены, какой скачать? Нажмите меню Apple () → «Об этом Mac», чтобы проверить тип чипа. Если вы видите «Apple M1/M2/M3/M4», выберите версию arm64. Если видите «Intel», выберите версию x64.

Начиная с версии 0.46.5 установщик PKG подписан и нотаризован, поэтому macOS открывает его без дополнительных шагов.

Шаг 2: Установить PKG

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

Процесс установки

  1. Найдите загруженный файл .pkg в папке Загрузки (например, Sokuji-x.x.x-arm64.pkg или Sokuji-x.x.x-x64.pkg)
  2. Дважды щелкните по файлу PKG, чтобы начать установку
  3. Откроется установщик macOS — нажмите «Продолжить» для продолжения
  4. Просмотрите детали установки и нажмите «Установить»
  5. Введите пароль администратора при запросе (необходим для установки драйвера)
  6. Дождитесь завершения установки (обычно 1-2 минуты)
  7. Нажмите «Закрыть» после завершения установки

Что устанавливается

  • Sokuji.app - Устанавливается в /Applications
  • SokujiVirtualAudio.driver - Виртуальный аудиодрайвер, устанавливаемый в /Library/Audio/Plug-Ins/HAL
  • Установщик автоматически перезапустит CoreAudio для загрузки драйвера
Пароль администратора необходим, потому что установщику нужно установить системный аудиодрайвер. Виртуальный аудиодрайвер обеспечивает расширенные функции обработки звука.

Шаг 3: Первый запуск

Откройте Sokuji из папки «Программы». Дополнительные шаги безопасности не нужны.

Шаг 4: Настроить Sokuji

Теперь, когда Sokuji запущен, давайте настроим его для первого использования:

Начальная настройка

  1. Предоставьте разрешения на доступ к микрофону, когда macOS запросит
  2. Выберите предпочитаемый язык интерфейса
  3. Выберите поставщика ИИ (OpenAI, Google Gemini и т.д.)
  4. Введите API-ключ для выбранного поставщика
  5. Выберите исходный и целевой языки для перевода
  6. Выберите микрофон, а в блоке Речь выберите динамики или наушники как Устройство воспроизведения по умолчанию. Собственное виртуальное аудиоустройство Sokuji там не показывается: Перевод, который слышит собеседник отправляет в него ваш перевод, это виртуальный микрофон, который вы выбираете в приложении для встреч
  7. Протестируйте настройку микрофона и динамиков
Поздравляем! Sokuji готов к использованию. Виртуальный аудиодрайвер установлен и доступен в вашем списке аудиоустройств. Нажмите кнопку микрофона, чтобы начать перевод в реальном времени.

Устранение неполадок

Микрофон не работает

Если Sokuji не может получить доступ к микрофону:
  1. Откройте Системные настройки → Защита и безопасность → Конфиденциальность
  2. Выберите Микрофон в левой боковой панели
  3. Убедитесь, что Sokuji отмечен в списке
  4. Если его нет в списке, перезапустите Sokuji и предоставьте разрешение при запросе

Нет аудиовыхода

Если вы не слышите переведенный звук:
  1. Откройте Системные настройки → Звук → Выход
  2. Выберите предпочитаемое устройство вывода
  3. Проверьте, не отключена ли громкость вывода
  4. В блоке Речь в Sokuji проверьте устройство той строки, которую вы ожидаете услышать: Я тоже слышу для вашего собственного перевода (по умолчанию выключено), Перевод, который слышу я для перевода собеседника и Устройство воспроизведения по умолчанию для всего остального

Приложение вылетает на Mac с Intel или проблемы с производительностью

Убедитесь, что вы скачали правильный установщик для вашего Mac:
  • Apple Silicon (M1/M2/M3/M4): Используйте Sokuji-x.x.x-arm64.pkg
  • Intel: Используйте Sokuji-x.x.x-x64.pkg
  • Проверьте тип чипа: меню Apple () → «Об этом Mac»
  • Если использовали неправильный установщик, скачайте правильную версию со страницы релизов
  • Если вылеты продолжаются с правильным установщиком, проверьте Console.app для логов сбоев и сообщите о них на GitHub

Виртуальный аудиодрайвер не отображается

Если вы не видите «SokujiVirtualAudio» в аудиоустройствах:
  1. Сначала дайте Sokuji исправить это самому: если драйвер установлен, но macOS его не загрузила, Sokuji сообщает об этом при запуске и предлагает Исправить. Введите пароль администратора, и Sokuji перезапустит Core Audio, чтобы загрузить драйвер; перезапускать Sokuji не нужно
  2. Проверьте, установлен ли драйвер: ls /Library/Audio/Plug-Ins/HAL/
  3. Если отсутствует, возможно, потребуется переустановить Sokuji
  4. Если присутствует, а «Исправить» не помогло, попробуйте перезапустить CoreAudio: sudo killall coreaudiod, или перезагрузите Mac
  5. Проверьте Системные настройки → Звук, чтобы увидеть, появилось ли устройство

Установка требует пароль администратора

Это нормально и необходимо:
  • Установщик PKG должен установить системный аудиодрайвер
  • Системные аудиодрайверы требуют прав администратора для установки
  • Введите пароль при запросе — это безопасно и ожидаемо
  • Если у вас нет прав администратора, обратитесь к системному администратору