Linux-Installationsanleitung

Diese Anleitung fuehrt Sie durch die Installation von Sokuji auf Linux-Systemen. Sokuji ist als .deb-Paket fuer Debian/Ubuntu-basierte Distributionen und als AppImage fuer universelle Kompatibilitaet verfuegbar.

Fuer Linux herunterladen

Systemanforderungen

Ubuntu 20.04 oder spaeter, Debian 10 oder spaeter, oder aequivalente Distribution
64-Bit-Prozessor
Mindestens 4 GB RAM (8 GB empfohlen)
100 MB verfuegbarer Festplattenspeicher
PulseAudio oder PipeWire fuer Audio-Unterstuetzung
Internetverbindung fuer KI-Dienste

Installationsschritte

Schritt 1: Sokuji herunterladen

Besuchen Sie die offizielle GitHub-Releases-Seite, um die neueste Version von Sokuji fuer Linux herunterzuladen.

Verfuegbare Pakete

.deb-Paket - Fuer Debian/Ubuntu-basierte Distributionen
.AppImage - Universelles Paket fuer alle Linux-Distributionen
.rpm-Paket - Fuer Fedora/RHEL-basierte Distributionen (falls verfuegbar)

Schritt 2: .deb-Paket installieren (Ubuntu/Debian)

Wenn Sie Ubuntu, Debian oder deren Derivate verwenden, wird das .deb-Paket empfohlen.

Methode 1: Ueber die grafische Oberflaeche

Oeffnen Sie Ihren Dateimanager und navigieren Sie zum Downloads-Ordner
Doppelklicken Sie auf die Datei sokuji_*.deb
Klicken Sie auf "Installieren" im sich oeffnenden Software-Center
Geben Sie Ihr Passwort ein, wenn Sie dazu aufgefordert werden

Methode 2: Ueber das Terminal

Oeffnen Sie das Terminal und fuehren Sie die folgenden Befehle aus:

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

Bei Abhaengigkeitsproblemen beheben Sie diese mit:

sudo apt-get install -f

Schritt 3: AppImage installieren (Universell)

AppImage funktioniert auf allen Linux-Distributionen und erfordert keine Installation.

AppImage einrichten

Laden Sie die AppImage-Datei von der Releases-Seite herunter
Machen Sie sie ausfuehrbar:
```
chmod +x sokuji-*.AppImage
```
Starten Sie die Anwendung:
```
./sokuji-*.AppImage
```

Optional: Systemintegration

Um die AppImage mit Ihrem System zu integrieren:

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

Jetzt koennen Sie Sokuji von ueberall aus starten, indem Sie sokuji im Terminal eingeben.

Schritt 4: Ersteinrichtung

Beim ersten Start von Sokuji muessen Sie es konfigurieren:

Ersteinrichtung

Starten Sie Sokuji ueber das Anwendungsmenue oder Terminal
Waehlen Sie Ihre bevorzugte Oberflaechensprache
Konfigurieren Sie Ihren KI-Anbieter (OpenAI, Google Gemini usw.)
Geben Sie Ihren API-Schluessel fuer den ausgewaehlten Anbieter ein
Waehlen Sie Ihre Mikrofon- und Lautsprechergeraete
Testen Sie das Audio, um sicherzustellen, dass alles funktioniert

Sokuji ist jetzt einsatzbereit! Sie koennen die Echtzeit-Uebersetzung starten, indem Sie auf die Schaltflaeche zum Starten der Sitzung klicken.

Fehlerbehebung

Audio-Probleme

Wenn Sie Audio-Probleme haben:

Stellen Sie sicher, dass PulseAudio oder PipeWire laeuft: systemctl --user status pipewire
Ueberpruefen Sie die Audio-Berechtigungen: groups $USER sollte 'audio' enthalten
Starten Sie den Audio-Dienst neu: systemctl --user restart pipewire

Zugriff verweigert

Wenn Sie "Permission denied"-Fehler erhalten:

sudo usermod -a -G audio $USER

Melden Sie sich dann ab und wieder an, damit die Aenderungen wirksam werden.

Fehlende Abhaengigkeiten

Installieren Sie die erforderlichen Bibliotheken:

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

AppImage startet nicht

Wenn AppImage nicht startet, installieren Sie FUSE:

sudo apt-get install fuse libfuse2

Fuer neuere Systeme (Ubuntu 22.04+) benoetigen Sie moeglicherweise:

sudo apt-get install libfuse2t64