Installation

Hinweise zu den Release-Versionen

WSL Dashboard bietet drei verschiedene Release-Dateiformate an, um unterschiedliche Nutzungsszenarien abzudecken:

Versionstyp	Beispiel-Dateiname	Beschreibung
Portable Version (EXE)	WSLDashboard.vX.Y.Z.Portable.x64.exe	Empfohlene Methode. Einzeldatei, grün, keine Installation erforderlich, direkter Start. Die Konfiguration wird in ~\.wsldashboard gespeichert.
Portable Version (ZIP)	WSLDashboard.vX.Y.Z.Portable.x64.zip	Komprimierte portable Version, ideal für manuelle Bereitstellung oder Integration in Tool-Suiten.
Installationsversion (Setup)	WSLDashboard.vX.Y.Z.Setup.x64.exe	Standard-Installationsprogramm. Erstellt eine Verknüpfung im Startmenü, ein Desktopsymbol und registriert den System-Deinstallations-Eintrag.

TIP

Wie wählen?

• Wenn Sie Einfachheit und Schnelligkeit suchen, wählen Sie die portable Version (EXE).
• Wenn Sie es wie normale Software im „Startmenü" finden möchten, wählen Sie die Installationsversion (Setup).

Installationsmethoden

WSL Dashboard bietet vier Installationsmethoden; wählen Sie die, die Ihnen am besten gefällt:

Methode 1: Download von der offiziellen Website (empfohlen)

Besuchen Sie die offizielle Download-Seite und wählen Sie den für Ihre Region geeigneten Spiegel.

Methode 2: Installation über winget

Installieren Sie direkt über den Windows-Paketmanager (winget):

winget search wsl-dashboard
winget install wsl-dashboard

Die winget-Paketkennung lautet Owu.WSLDashboard, der Alias wsl-dashboard (ohne Beachtung von Groß-/Kleinschreibung); beide sind gültig.

Methode 3: Vorkompilierte Binärdateien von GitHub Releases

Gehen Sie zur Seite GitHub Releases und laden Sie die neueste Version herunter. Wenn Sie das komprimierte Archiv herunterladen, entpacken Sie es und führen Sie direkt wsldashboard.exe aus – keine Installation erforderlich.

Methode 4: Build aus dem Quellcode

Wenn Sie selbst kompilieren möchten, stellen Sie sicher, dass Ihre Entwicklungsumgebung die folgenden Anforderungen erfüllt:

• Rust-Toolchain: Version 1.92 oder höher.
• Build-Ziel: x86_64-pc-windows-msvc.

Kompilierungsschritte

1. Repository klonen:

   git clone https://github.com/owu/wsl-dashboard.git
   cd wsl-dashboard

2. Entwicklungsausführung:

   cargo run .

3. Produktions-Build (mit dem bereitgestellten Skript):

   .\build\portable\build.ps1

Die Build-Artefakte befinden sich im Verzeichnis target/release.

Anleitung für die portable Version

Die portable Version benötigt keine Installation: führen Sie einfach wsldashboard.exe aus; die Konfiguration wird in ~\.wsldashboard gespeichert. Zum Deinstallieren genügt es, die Dateien zu löschen – es bleiben keine Systemrückstände. Die portable Version bietet exakt dieselben Funktionen wie die Installationsversion; es fehlen lediglich die Systemintegrationen wie Startmenü-Verknüpfung, Desktopsymbol und Deinstallations-Eintrag.