Skip to content

troubleshooting.md

Latest commit

 

History

History
260 lines (190 loc) · 4.86 KB

troubleshooting.md

File metadata and controls

260 lines (190 loc) · 4.86 KB
Raw

Fehlerbehebung – WindowsBridge

Allgemeine Probleme

1. Installation schlägt fehl

Problem: Installation bricht mit Fehler ab

Lösungen:

# Überprüfe Internetverbindung
ping 8.8.8.8

# Starte Installation mit Verbose Mode
sudo bash installer.sh --profile minimal --verbose

# Nutze Dry-run zur Simulation
sudo bash installer.sh --dry-run

2. Sudo-Passwort wird nicht akzeptiert

Problem: "sudo: keine Passwort-Eingabe möglich"

Lösungen:

  • Öffne ein neues Terminal
  • Starte Installation erneut
  • Überprüfe Caps-Lock

3. Fehlende Abhängigkeiten

Problem: "Modul nicht gefunden" oder ähnlich

Lösungen:

# Aktualisiere Paketlisten
sudo apt-get update

# Installiere fehlende Pakete
sudo apt-get install -y yad python3

Wine-Probleme

1. Wine funktioniert nicht

Problem: Wine-Befehl wird nicht erkannt

Lösungen:

# Überprüfe Installation
which wine
wine --version

# Neu installieren
sudo apt-get remove wine -y
sudo apt-get install wine -y

2. Prefix-Fehler

Problem: "Fehler beim Erstellen des Wine-Prefix"

Lösungen:

# Löschen Sie den alten Prefix
rm -rf ~/.wine

# Starten Sie Wine-Setup neu
bash modules/wine_setup.sh

3. Anwendung startet nicht unter Wine

Problem: Exe-Datei wird nicht ausgeführt

Lösungen:

# Überprüfe Wine mit Beispiel
wine notepad

# Prüfe auf Fehlermeldungen im Detail
WINEDEBUG=+all wine /pfad/zur/app.exe

# Installiere fehlende Runtimes
WINEPREFIX=~/.wine winetricks vcrun2022

Gaming-Probleme

1. Spiel läuft nicht

Problem: Spiel startet nicht oder stürzt ab

Lösungen:

# Überprüfe Proton-Installation
steam

# Aktiviere Proton GE in Steam:
# Steam → Einstellungen → Steam Play → 
# Aktiviere "Steam Play für nicht unterstützte Spiele"

# Nutze MangoHUD zur Diagnostik
mangohud %command%

2. Grafik-Fehler / Black Screen

Problem: Spiel startet, aber zeigt nur schwarzen Bildschirm

Lösungen:

# Überprüfe GPU-Treiber
glxinfo | grep "OpenGL version"

# Überprüfe Vulkan
vulkaninfo

# Aktiviere DXVK Debug
DXVK_HUD=memory wine /pfad/zur/app.exe

3. Performance-Probleme

Problem: Spiel läuft langsam oder ruckelt

Lösungen:

# Aktiviere GameMode
gamemoderun %command%

# Nutze MangoHUD zur Monitoring
mangohud --dlsym

# Überprüfe CPU-Frequenzumskalierung
watch -n1 'cat /proc/cpuinfo | grep MHz'

Treiber-Probleme

1. GPU wird nicht erkannt

Problem: "Unbekannte GPU" oder keine Vulkan-Unterstützung

Lösungen:

# Überprüfe PCI-Geräte
lspci | grep -i vga

# Überprüfe Vulkan
vulkaninfo | grep "GPU max timestep"

# Für NVIDIA:
nvidia-smi

# Für AMD:
rocminfo

2. Falsche Treiber installiert

Problem: Falsche GPU-Treiber oder mehrere Versionen

Lösungen:

# Überprüfe installierte Treiber
apt search nvidia-driver | grep installed

# Entferne alte Treiber
sudo apt-get remove nvidia-* -y
sudo apt-get autoremove -y

# Neu installieren
sudo bash modules/system_setup.sh

Netzwerk-Probleme

1. Keine Internetverbindung während Installation

Problem: "Paket konnte nicht heruntergeladen werden"

Lösungen:

# Überprüfe Netzwerk
ping 8.8.8.8
ip route show

# Überprüfe DNS
cat /etc/resolv.conf

# Versuche Installation später

Steam/Lutris Probleme

1. Steam startet nicht

Problem: Steam-Fehler oder wird nicht ausgeführt

Lösungen:

# Überprüfe Installation
which steam

# Starten Sie mit Debug
steam -debug

# Entfernen und neuinstallieren
sudo apt-get remove steam -y
sudo bash modules/gaming_setup.sh

2. Lutris funktioniert nicht

Problem: Lutris GUI wird nicht angezeigt

Lösungen:

# Überprüfe Installation
which lutris

# Starten mit Terminal-Ausgabe
lutris --version
lutris -d

# Neu installieren
sudo apt-get remove lutris -y
sudo bash modules/gaming_setup.sh

Häufige Fehler-Codes

Code Bedeutung Lösung
1 Allgemeiner Fehler Siehe Fehlermeldung oben
126 Datei nicht ausführbar chmod +x script.sh
127 Befehl nicht gefunden Überprüfe Installation
255 SSH/Verbindungsfehler Überprüfe Netzwerk

Debug-Modus

Für tieferes Debugging aktiviere Debug-Ausgabe:

# Maximales Debugging
bash -x modules/wine_setup.sh 2>&1 | tee debug.log

# Wine-Debugging
WINEDEBUG=+all wine program.exe 2>&1 | tee wine_debug.log

# Vulkan-Debugging
RADV_DEBUG=all vkpinfo | head -20

Support kontaktieren

Wenn Sie nicht selbst lösen können:

  1. Sammeln Sie die Debug-Logs
  2. Notieren Sie:
    • Ihr System (Ubuntu/Debian Version)
    • GPU-Modell
    • Installiertes Profil
    • Genaue Fehlermeldung
  3. Erstellen Sie ein GitHub Issue mit dieser Information

Hinweis: Viele Probleme werden durch fehlende Updates gelöst:

sudo bash modules/updater.sh