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

Посібник зі встановлення на macOS

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

Завантажити для macOS

Системні вимоги

  • macOS 10.15 (Catalina) або новіша
  • Процесор 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.

Інсталятор PKG не підписаний, що означає, що вам потрібно буде виконати спеціальні кроки для його встановлення (описано в наступному кроці).

Крок 2: Підготовка до встановлення

Оскільки інсталятор PKG не підписаний, macOS заблокує його за замовчуванням. Необхідно видалити атрибут карантину перед встановленням.

Видалення атрибута карантину (обовʼязково)

  1. Відкрийте Terminal (Програми → Утиліти → Terminal)
  2. Введіть або вставте наступну команду (замініть x.x.x на номер вашої версії):

    sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-x.x.x-arm64.pkg

    Для Mac з Intel використовуйте: sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-x.x.x-x64.pkg

  3. Натисніть Enter та введіть пароль адміністратора при запиті
  4. Команда завершиться без виводу (відсутність виводу означає успіх)

Що це робить? Ця команда видаляє прапорець карантину, який macOS додає до завантажених файлів. Це безпечно та необхідно для непідписаних інсталяторів PKG.

Цей крок критично важливий! Без видалення атрибута карантину інсталятор PKG не зможе відкритися або встановитися.

Крок 3: Встановити 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 для завантаження драйвера
Пароль адміністратора необхідний, оскільки інсталятору потрібно встановити системний аудіодрайвер. Віртуальний аудіодрайвер забезпечує розширені функції обробки звуку.

Крок 4: Перший запуск

Після встановлення вам може знадобитися дозволити запуск Sokuji, оскільки програму завантажено не з App Store.

Перший запуск Sokuji

  1. Перейдіть до папки Програми
  2. Знайдіть Sokuji у списку
  3. Клацніть правою кнопкою миші (або Control-клацніть) на Sokuji
  4. Оберіть "Відкрити" з контекстного меню
  5. Коли зʼявиться діалог безпеки, натисніть "Відкрити" для підтвердження

Примітка: Якщо ви правильно виконали Крок 2, попередження безпеки можуть не зʼявитися.

Альтернативний спосіб

Якщо macOS продовжує блокувати Sokuji:
  1. Відкрийте Системні налаштування → Безпека та конфіденційність
  2. Перейдіть на вкладку Загальні
  3. Ви повинні побачити повідомлення про блокування Sokuji
  4. Натисніть "Все одно відкрити"
Це попередження безпеки зʼявляється лише при першому запуску. Після цього ви можете відкривати Sokuji звичайним способом з Launchpad або Програм.

Крок 5: Налаштувати Sokuji

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

Початкове налаштування

  1. Надайте дозвіл на доступ до мікрофона, коли macOS запитає
  2. Оберіть бажану мову інтерфейсу
  3. Оберіть постачальника ШІ (OpenAI, Google Gemini тощо)
  4. Введіть API-ключ для обраного постачальника
  5. Оберіть мову джерела та цільову мову для перекладу
  6. Оберіть аудіопристрої (ви повинні бачити "Sokuji Virtual Audio" у списку)
  7. Протестуйте налаштування мікрофона та динаміків
Вітаємо! Sokuji готовий до використання. Віртуальний аудіодрайвер встановлено та доступний у вашому списку аудіопристроїв. Натисніть кнопку мікрофона, щоб розпочати переклад у реальному часі.

Усунення несправностей

"Пакет пошкоджений і не може бути відкритий" або PKG не встановлюється

Це трапляється, коли атрибут карантину не було видалено з файлу PKG:
  1. Відкрийте Terminal (Програми → Утиліти → Terminal)
  2. Виконайте: sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-*.pkg
  3. Введіть пароль при запиті
  4. Спробуйте встановити PKG знову
Це найпоширеніша проблема встановлення непідписаних PKG-інсталяторів.

"Sokuji неможливо відкрити, оскільки він від невідомого розробника"

Це трапляється, якщо ви не виконали команду xattr перед встановленням:
  1. Клацніть правою кнопкою миші на програмі Sokuji у Програмах
  2. Оберіть "Відкрити" з меню
  3. Натисніть "Відкрити" у діалозі, що зʼявиться
Це потрібно зробити лише один раз. Кращий підхід: видаліть та перевстановіть після видалення атрибута карантину.

Мікрофон не працює

Якщо 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

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

Якщо ви не бачите "Sokuji Virtual Audio" в аудіопристроях:
  1. Перевірте, чи встановлено драйвер: ls /Library/Audio/Plug-Ins/HAL/
  2. Якщо відсутній, можливо, потрібно перевстановити Sokuji
  3. Якщо присутній, спробуйте перезапустити CoreAudio: sudo killall coreaudiod
  4. Перевірте Системні налаштування → Звук, чи зʼявився пристрій

Встановлення вимагає пароль адміністратора

Це нормально та необхідно:
  • Інсталятор PKG повинен встановити системний аудіодрайвер
  • Системні аудіодрайвери вимагають прав адміністратора для встановлення
  • Введіть пароль при запиті — це безпечно та очікувано
  • Якщо у вас немає прав адміністратора, звʼяжіться з системним адміністратором