Guide d'installation Linux

Ce guide vous accompagnera dans l'installation de Sokuji sur les systemes Linux. Sokuji est disponible sous forme de paquet .deb pour les distributions basees sur Debian/Ubuntu et en tant qu'AppImage pour une compatibilite universelle.

Telecharger pour Linux

Configuration requise

Ubuntu 20.04 ou ulterieur, Debian 10 ou ulterieur, ou distribution equivalente
Processeur 64 bits
4 Go de RAM minimum (8 Go recommandes)
100 Mo d'espace disque disponible
PulseAudio ou PipeWire pour le support audio
Connexion Internet pour les services d'IA

Etapes d'installation

Etape 1 : Telecharger Sokuji

Visitez la page officielle des versions sur GitHub pour telecharger la derniere version de Sokuji pour Linux.

Paquets disponibles

Paquet .deb - Pour les distributions basees sur Debian/Ubuntu
.AppImage - Paquet universel pour toutes les distributions Linux
Paquet .rpm - Pour les distributions basees sur Fedora/RHEL (si disponible)

Etape 2 : Installer le paquet .deb (Ubuntu/Debian)

Si vous utilisez Ubuntu, Debian ou leurs derives, le paquet .deb est recommande.

Methode 1 : Utilisation de l'interface graphique

Ouvrez votre gestionnaire de fichiers et naviguez vers le dossier Telechargements
Double-cliquez sur le fichier sokuji_*.deb
Cliquez sur "Installer" dans le Centre de logiciels qui s'ouvre
Saisissez votre mot de passe lorsque demande

Methode 2 : Utilisation du terminal

Ouvrez le Terminal et executez les commandes suivantes :

cd ~/Downloads
sudo dpkg -i sokuji_*.deb

Si vous rencontrez des problemes de dependances, corrigez-les avec :

sudo apt-get install -f

Etape 3 : Installer l'AppImage (Universel)

AppImage fonctionne sur toutes les distributions Linux et ne necessite pas d'installation.

Configurer l'AppImage

Telechargez le fichier AppImage depuis la page des versions
Rendez-le executable :
```
chmod +x sokuji-*.AppImage
```
Executez l'application :
```
./sokuji-*.AppImage
```

Optionnel : Integration systeme

Pour integrer l'AppImage a votre systeme :

mkdir -p ~/.local/bin
cp sokuji-*.AppImage ~/.local/bin/sokuji
chmod +x ~/.local/bin/sokuji

Vous pouvez maintenant executer Sokuji depuis n'importe ou en tapant sokuji dans le terminal.

Etape 4 : Configuration du premier lancement

Lorsque vous lancez Sokuji pour la premiere fois, vous devrez le configurer :

Configuration initiale

Lancez Sokuji depuis le menu des applications ou le terminal
Selectionnez votre langue d'interface preferee
Configurez votre fournisseur d'IA (OpenAI, Google Gemini, etc.)
Saisissez votre cle API pour le fournisseur selectionne
Selectionnez vos peripheriques microphone et haut-parleurs
Testez l'audio pour vous assurer que tout fonctionne

Sokuji est maintenant pret a l'emploi ! Vous pouvez demarrer la traduction en temps reel en cliquant sur le bouton de demarrage de session.

Depannage

Problemes audio

Si vous rencontrez des problemes audio :

Assurez-vous que PulseAudio ou PipeWire est en cours d'execution : systemctl --user status pipewire
Verifiez les permissions audio : groups $USER devrait inclure 'audio'
Redemarrez le service audio : systemctl --user restart pipewire

Permission refusee

Si vous obtenez des erreurs "Permission denied" :

sudo usermod -a -G audio $USER

Puis deconnectez-vous et reconnectez-vous pour que les changements prennent effet.

Dependances manquantes

Installez les bibliotheques requises :

sudo apt-get update
sudo apt-get install libgtk-3-0 libnotify4 libnss3 libxss1 \
    libxtst6 xdg-utils libatspi2.0-0 libdrm2 libgbm1

L'AppImage ne s'execute pas

Si l'AppImage ne se lance pas, installez FUSE :

sudo apt-get install fuse libfuse2

Pour les systemes plus recents (Ubuntu 22.04+), vous pourriez avoir besoin de :

sudo apt-get install libfuse2t64