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

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

Цей посібник допоможе вам встановити Sokuji на системи Linux. Sokuji доступний як пакет .deb для дистрибутивів на базі Debian/Ubuntu та як AppImage для універсальної сумісності.

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

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

  • Ubuntu 20.04 або новіша, Debian 10 або новіша, або еквівалентний дистрибутив
  • 64-розрядний процесор
  • Мінімум 4 ГБ оперативної памʼяті (рекомендовано 8 ГБ)
  • 100 МБ вільного дискового простору
  • PulseAudio або PipeWire для підтримки звуку
  • Підключення до інтернету для служб ШІ

Кроки встановлення

Крок 1: Завантажити Sokuji

Відвідайте офіційну сторінку релізів на GitHub, щоб завантажити останню версію Sokuji для Linux.

Доступні пакети

  • Пакет .deb - Для дистрибутивів на базі Debian/Ubuntu
  • .AppImage - Універсальний пакет для всіх дистрибутивів Linux
  • Пакет .rpm - Для дистрибутивів на базі Fedora/RHEL (якщо доступний)

Крок 2: Встановлення пакету .deb (Ubuntu/Debian)

Якщо ви використовуєте Ubuntu, Debian або їх похідні, рекомендується пакет .deb.

Спосіб 1: Через графічний інтерфейс

  1. Відкрийте файловий менеджер та перейдіть до папки Завантаження
  2. Двічі клацніть на файл sokuji_*.deb
  3. Натисніть "Встановити" у Центрі програм, що відкриється
  4. Введіть пароль при запиті

Спосіб 2: Через термінал

Відкрийте Термінал та виконайте наступні команди:
cd ~/Downloads
sudo dpkg -i sokuji_*.deb
Якщо виникнуть проблеми із залежностями, виправте їх командою:
sudo apt-get install -f

Крок 3: Встановлення AppImage (Універсальний)

AppImage працює на всіх дистрибутивах Linux та не потребує встановлення.

Налаштування AppImage

  1. Завантажте файл AppImage зі сторінки релізів
  2. Зробіть його виконуваним:
    chmod +x sokuji-*.AppImage
  3. Запустіть програму:
    ./sokuji-*.AppImage

Необовʼязково: Інтеграція з системою

Для інтеграції AppImage з системою:
mkdir -p ~/.local/bin
cp sokuji-*.AppImage ~/.local/bin/sokuji
chmod +x ~/.local/bin/sokuji
Тепер ви можете запускати Sokuji з будь-якого місця, ввівши sokuji у терміналі.

Крок 4: Налаштування першого запуску

При першому запуску Sokuji необхідно його налаштувати:

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

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

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

Проблеми зі звуком

Якщо у вас проблеми зі звуком:
  • Переконайтеся, що PulseAudio або PipeWire запущено: systemctl --user status pipewire
  • Перевірте дозволи звуку: groups $USER має включати 'audio'
  • Перезапустіть звукову службу: systemctl --user restart pipewire

Відмова в доступі

Якщо ви отримуєте помилки "Permission denied":
sudo usermod -a -G audio $USER
Потім вийдіть із системи та увійдіть знову, щоб зміни набули чинності.

Відсутні залежності

Встановіть необхідні бібліотеки:
sudo apt-get update
sudo apt-get install libgtk-3-0 libnotify4 libnss3 libxss1 \
    libxtst6 xdg-utils libatspi2.0-0 libdrm2 libgbm1

AppImage не запускається

Якщо AppImage не запускається, встановіть FUSE:
sudo apt-get install fuse libfuse2
Для новіших систем (Ubuntu 22.04+) може знадобитися:
sudo apt-get install libfuse2t64