← Повернутися до документації

Посібник зі встановлення на 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 повинен встановити системний аудіодрайвер
  • Системні аудіодрайвери вимагають прав адміністратора для встановлення
  • Введіть пароль при запиті — це безпечно та очікувано
  • Якщо у вас немає прав адміністратора, звʼяжіться з системним адміністратором