Skip to content

README.md

Latest commit

 

History

History
204 lines (153 loc) · 6.01 KB

README.md

File metadata and controls

204 lines (153 loc) · 6.01 KB
Raw

🐧 WindowsBridge – One-Click Installer für Debian-basierte Linux-Systeme

WindowsBridge Logo

Version: 1.0.0 | License: Apache-2.0 | Status: ✅ Production Ready

Vision

WindowsBridge ist ein benutzerfreundlicher One-Click-Installer, der automatisch alle notwendigen Komponenten installiert und konfiguriert, um Windows-Software und Spiele komfortabel unter Linux zu nutzen.

Zielgruppe

  • Windows-Umsteiger
  • Linux-Einsteiger
  • Gamer
  • Office-/Business-User
  • Alle, die Windows-Programme unter Linux nutzen müssen

Systemanforderungen

  • OS: Debian 10+ oder Ubuntu 20.04+
  • Speicher: 5 GB freier Speicherplatz (empfohlen 10 GB)
  • RAM: 4 GB Minimum (8 GB empfohlen)
  • Internet: Stabile Verbindung erforderlich
  • Zugriff: Sudo-Berechtigung erforderlich
  • Tools: Bash 4.0+, Python 3.6+ (für GUI)

Unterstützte Systeme

  • ✅ Debian 10 (Buster) & später
  • ✅ Ubuntu 20.04 LTS & später
  • ✅ Linux Mint 19+ (auf Ubuntu-Basis)
  • ✅ LMDE 4+ (auf Debian-Basis)
  • ✅ Andere Debian-Derivate

Features

  • Systemvorbereitung: 32-bit-Bibliotheken, Vulkan, GPU-Treiber, Kernel-Optimierung
  • Wine-Umgebung: Wine, Winetricks, Runtimes, Registry-Tweaks
  • Gaming-Komponenten: DXVK, VKD3D-Proton, Proton-GE, Steam, Lutris, Heroic
  • Grafische GUI: Benutzerfreundliche Yad-basierte Oberfläche
  • Profile: Minimal, Standard, Gaming, Full, Custom
  • Aktualisierungen: Integrierte Update-Funktion

Installation

sudo bash installer.sh

Oder mit erweiterten Optionen:

sudo bash installer.sh --profile gaming --verbose

Projektstruktur

windowsbridge/
├── installer.sh              # Hauptinstaller mit Profilauswahl
├── modules/                  # Modulare Komponenten
│   ├── system_setup.sh      # Systemvorbereitung
│   ├── wine_setup.sh        # Wine-Umgebung
│   ├── gaming_setup.sh      # Gaming-Komponenten
│   ├── updater.sh           # Update-Routine
│   └── gui_launcher.py      # Grafische Oberfläche (Yad)
├── assets/                  # Grafiken und Ressourcen
│   └── logo.png            # WindowsBridge Logo
├── docs/                    # Dokumentation
│   ├── architecture.md      # Technische Architektur
│   ├── troubleshooting.md   # Fehlerbehebung
│   ├── compatibility.md     # Kompatibilitätsliste
│   └── FAQ.md              # Häufig gestellte Fragen
└── README.md               # Diese Datei

Philosophie

  • Komfortorientiert: Automatik für häufige Aufgaben
  • Modular: Wähle aus, was du installieren möchtest
  • Windows-ähnlich: Möglichst wenig Terminal
  • Einsteigerfreundlich: Klare Anleitung und Erklärungen
  • Power-User-freundlich: CLI- und erweiterte Optionen verfügbar

Dokumentation

Siehe die ausführliche Dokumentation in docs/ für:

  • Architektur und Modulbeschreibung

Lizenzierung

WindowsBridge ist unter der Apache License 2.0 lizenziert.

Copyright (c) 2026 Stefan

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Siehe die Datei LICENSE für den vollständigen Lizenztext.

Branding & Stil

Projektname: WindowsBridge
Tagline: One-Click Installer für Windows-Software auf Linux
Farbschema: Blau (#0066CC) & Weiß
Tonalität: Seriös, freundlich, informativ
Zielgruppe: Anfänger bis fortgeschrittene Linux-Nutzer

Support & Community

Letzte Aktualisierung: 2026-01-24
Version: 1.0.0
Status: ✅ Production Ready

  • Fehlerbehebung
  • Kompatibilitätsliste
  • FAQ

Ein-Klick Installation per Doppelklick

Desktop-Starter einrichten

WindowsBridge kann mit nur zwei Klicks installiert werden:

1. Starter ins System integrieren (einmalig)

Unter GNOME/Ubuntu:

# Kopiere den .desktop Launcher ins Anwendungsmenü
cp WindowsBridge.desktop ~/.local/share/applications/

# Oder ins systemweite Menü (erfordert sudo)
sudo cp WindowsBridge.desktop /usr/share/applications/

Unter KDE Plasma:

# KDE nutzt den gleichen Standard
cp WindowsBridge.desktop ~/.local/share/applications/

Unter Xfce/LXDE:

# Auch hier ist der Standard gleich
cp WindowsBridge.desktop ~/.local/share/applications/

2. Installation starten

Nach der Integration erscheint "WindowsBridge Installer" in deinem Anwendungsmenü:

  1. Öffne das Menü (Super/Windows-Taste)
  2. Tippe "WindowsBridge" ein
  3. Klicke auf "WindowsBridge Installer"
  4. Folge den Anweisungen

Oder per Terminal:

bash start-windowsbridge.sh

Desktop-Datei manuell anpassen

Falls du den Pfad ändern möchtest, bearbeite WindowsBridge.desktop:

# Bearbeite die Exec-Zeile
nano WindowsBridge.desktop

# Ändere diese Zeile:
Exec=env WINDOWSBRIDGE_DIR=%{PWD} bash /pfad/zu/start-windowsbridge.sh

Lizenz

(Hier später definieren)

Beiträge

(Beitrittsrichtlinien hier später)

Hinweis: Dieses Projekt wurde erstellt, um die Einstiegshürde für Linux-Anfänger und Windows-Umsteiger zu senken. Technische Kenntnisse sind nicht erforderlich!