Guida all'installazione su Linux

Questa guida vi accompagnera nell'installazione di Sokuji sui sistemi Linux. Sokuji e disponibile come pacchetto .deb per le distribuzioni basate su Debian/Ubuntu e come AppImage per la compatibilita universale.

Scarica per Linux

Requisiti di sistema

Ubuntu 20.04 o successivo, Debian 10 o successivo, o distribuzione equivalente
Processore a 64 bit
4 GB di RAM minimo (8 GB consigliati)
100 MB di spazio su disco disponibile
PulseAudio o PipeWire per il supporto audio
Connessione Internet per i servizi di IA

Passaggi dell'installazione

Passaggio 1: Scaricare Sokuji

Visitate la pagina ufficiale delle release su GitHub per scaricare l'ultima versione di Sokuji per Linux.

Pacchetti disponibili

Pacchetto .deb - Per le distribuzioni basate su Debian/Ubuntu
.AppImage - Pacchetto universale per tutte le distribuzioni Linux
Pacchetto .rpm - Per le distribuzioni basate su Fedora/RHEL (se disponibile)

Passaggio 2: Installare il pacchetto .deb (Ubuntu/Debian)

Se utilizzate Ubuntu, Debian o le loro derivate, si consiglia il pacchetto .deb.

Metodo 1: Tramite interfaccia grafica

Aprite il gestore dei file e navigate alla cartella Download
Fate doppio clic sul file sokuji_*.deb
Cliccate su "Installa" nel Centro Software che si apre
Inserite la password quando richiesto

Metodo 2: Tramite terminale

Aprite il Terminale ed eseguite i seguenti comandi:

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

Se riscontrate problemi di dipendenze, correggeteli con:

sudo apt-get install -f

Passaggio 3: Installare AppImage (Universale)

AppImage funziona su tutte le distribuzioni Linux e non richiede installazione.

Configurare AppImage

Scaricate il file AppImage dalla pagina delle release
Rendetelo eseguibile:
```
chmod +x sokuji-*.AppImage
```
Eseguite l'applicazione:
```
./sokuji-*.AppImage
```

Opzionale: Integrazione di sistema

Per integrare l'AppImage con il vostro sistema:

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

Ora potete eseguire Sokuji da qualsiasi posizione digitando sokuji nel terminale.

Passaggio 4: Configurazione del primo avvio

Al primo avvio di Sokuji, dovrete configurarlo:

Configurazione iniziale

Avviate Sokuji dal menu delle applicazioni o dal terminale
Selezionate la vostra lingua dell'interfaccia preferita
Configurate il vostro fornitore di IA (OpenAI, Google Gemini, ecc.)
Inserite la vostra chiave API per il fornitore selezionato
Selezionate i dispositivi microfono e altoparlanti
Testate l'audio per assicurarvi che tutto funzioni

Sokuji e ora pronto per l'uso! Potete avviare la traduzione in tempo reale cliccando sul pulsante di avvio sessione.

Risoluzione dei problemi

Problemi audio

Se riscontrate problemi audio:

Assicuratevi che PulseAudio o PipeWire sia in esecuzione: systemctl --user status pipewire
Verificate i permessi audio: groups $USER dovrebbe includere 'audio'
Riavviate il servizio audio: systemctl --user restart pipewire

Permesso negato

Se ottenete errori "Permission denied":

sudo usermod -a -G audio $USER

Quindi disconnettetevi e riconnettetevi per rendere effettive le modifiche.

Dipendenze mancanti

Installate le librerie necessarie:

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

AppImage non si avvia

Se AppImage non si avvia, installate FUSE:

sudo apt-get install fuse libfuse2

Per sistemi piu recenti (Ubuntu 22.04+), potreste aver bisogno di:

sudo apt-get install libfuse2t64