Skip to content

QUICKSTART.md

Latest commit

 

History

History
251 lines (185 loc) · 5.34 KB

QUICKSTART.md

File metadata and controls

251 lines (185 loc) · 5.34 KB
Raw

WindowsBridge – Quick Start Guide

Schneller Einstieg in WindowsBridge in 5 Minuten!

Voraussetzungen

  • ✅ Debian/Ubuntu basiertes System
  • ✅ Mindestens 5 GB freier Speicherplatz
  • ✅ Internetverbindung
  • ✅ Sudo-Zugriff
  • ✅ Bash 4.0+ (normalerweise vorinstalliert)

Option 1: Installation über GUI (Einfachste Methode)

# 1. GUI-Launcher starten
python3 windowsbridge/modules/gui_launcher.py

# 2. Profil auswählen (minimal, standard, gaming, full)
# 3. Bestätigung clicken
# 4. Warten Sie, bis die Installation abgeschlossen ist

Vorteile:

  • Keine Terminal-Kompetenzen erforderlich
  • Visuelle Bestätigung aller Schritte
  • Fehlertoleranz mit Dialog-Meldungen

Option 2: Installation über Terminal (Fortgeschrittene)

Schritt 1: Projekt klonen/herunterladen

cd ~/Documents
# oder Datei entpacken
unzip WindowsBridge.zip
cd windowsbridge

Schritt 2: Profil auswählen

# Minimal Installation (nur Windows-Basics)
sudo bash installer.sh --profile minimal

# Standard Installation (Windows + Wine + Runtimes)
sudo bash installer.sh --profile standard

# Gaming Installation (Standard + Steam + Lutris + Heroic)
sudo bash installer.sh --profile gaming

# Vollständige Installation (Alles)
sudo bash installer.sh --profile full

# Benutzerdefiniert
sudo bash installer.sh --profile custom

Schritt 3: Warten Sie auf Abschluss

Das Skript wird:

  1. ✓ Systemvoraussetzungen überprüfen
  2. ✓ System-Pakete aktualisieren
  3. ✓ GPU-Treiber installieren
  4. ✓ Wine konfigurieren
  5. ✓ Gaming-Komponenten installieren
  6. ✓ Finale Tests durchführen

Zeitaufwand: 10-30 Minuten (je nach Internet & Profil)

Verwendungsbeispiele

Windows-Programm testen

# Beispiel: Notepad.exe ausführen
wine notepad.exe

# Beispiel: Game mit Steam starten
steam steam://run/570  # Dota 2

Verbose-Mode (für Debugging)

sudo bash installer.sh --profile gaming --verbose 2>&1 | tee install.log

Dry-Run (nur Simulation)

sudo bash installer.sh --profile gaming --dry-run

Nach der Installation

Tests ausführen

# Alle Tests
bash run_all_tests.sh

# Einzelne Tests
bash modules/test_system.sh
bash modules/test_wine.sh
bash modules/test_gaming.sh

Logs anzeigen

# Letzte Logs
tail ~/.config/windowsbridge/install_*.log
tail ~/.config/windowsbridge/test_*.log

# Alle Logs
ls -lh ~/.config/windowsbridge/

Updates installieren

# Nur überprüfen
sudo bash modules/updater.sh --check-only

# Installieren
sudo bash modules/updater.sh

# Vollständig updaten
sudo bash modules/updater.sh --full-update

Häufige Fragen

F: Was ist die beste Installation für Anfänger?

A: Starten Sie mit dem gaming Profil über die GUI. Das bietet die beste Balance zwischen Funktionalität und einfacher Bedienung.

F: Welche Größe hat die Installation?

A: Je nach Profil 2-15 GB. System-Pakete sind ~500 MB, Wine ~200 MB, Gaming-Komponenten ~5-10 GB.

F: Kann ich es deinstallieren?

A: Teilweise. Wine und Gaming-Apps können manuell deinstalliert werden:

sudo apt-get remove wine wine32 wine64 winetricks
sudo apt-get remove lutris steam gamemode mangohud

F: Funktioniert jedes Windows-Spiel?

A: Die meisten modernen Spiele funktionieren. Siehe compatibility.md für eine Liste getesteter Spiele.

F: Wie aktualisiere ich?

A: Regelmäßig updaten mit:

sudo bash modules/updater.sh

Troubleshooting

Problem: "sudo: bash: command not found"

Lösung:

sudo /bin/bash installer.sh --profile gaming

Problem: GPU-Treiber werden nicht erkannt

Lösung:

# Treiber-Installation erzwingen
sudo bash installer.sh --profile gaming --force-drivers

Problem: Wine-Prefix-Fehler

Lösung:

# Wine neu initialisieren
rm -rf ~/.wine
bash modules/wine_setup.sh

Problem: Logs sind zu klein/unvollständig

Lösung:

# Verbose-Mode aktivieren
sudo bash installer.sh --profile gaming --verbose

Mehr Lösungen: Siehe troubleshooting.md

Nächste Schritte

  1. ✅ Installation durchführen
  2. ✅ Tests ausführen (bash run_all_tests.sh)
  3. ✅ Erste App testen (wine notepad.exe)
  4. ✅ Gaming-Launcher konfigurieren (Steam, Lutris)
  5. ✅ Bei Problemen troubleshooting.md lesen

Weitere Ressourcen

Support

Falls etwas nicht funktioniert:

  1. Check Logs:

    tail ~/.config/windowsbridge/install_*.log

  2. Run Tests:

    bash run_all_tests.sh --verbose

  3. Read Documentation:

  4. Manual Debugging:

    # System-Infos
uname -a
dpkg --print-architecture
lspci | grep -i VGA
glxinfo | head -20

Viel Erfolg bei der Installation! 🚀

Version: 1.0.0
Letztes Update: 2026