Initial commit — Proxmox SPICE Client (Electron)

2026-07-01 09:23:50 +02:00
commit efb8c7f446
15 changed files with 1223 additions and 0 deletions
@@ -0,0 +1,94 @@
+# Build — Proxmox SPICE Client
+
+## Voraussetzungen
+
+```bash
+node >= 18
+npm >= 9
+```
+
+Für Linux-Builds auf Linux-Host, für Windows-Builds entweder Windows oder Wine (cross-build eingeschränkt — lieber nativ bauen).
+
+## Entwicklung
+
+```bash
+npm install
+npm start
+```
+
+## Produktions-Build
+
+### Linux (AppImage + .deb)
+```bash
+npm run build:linux
+# Output: dist/Proxmox SPICE Client-1.0.0.AppImage
+#         dist/proxmox-spice-client_1.0.0_amd64.deb
+```
+
+### Windows (.exe Installer)
+```bash
+npm run build:win
+# Output: dist/Proxmox SPICE Client Setup 1.0.0.exe
+```
+
+### Beides auf einmal
+```bash
+npm run build:linux && npm run build:win
+```
+
+## Icons
+
+Dateien in `assets/` müssen vor dem Build vorhanden sein:
+
+| Datei | Größe | Verwendung |
+|-------|-------|------------|
+| `assets/icon.png` | mind. 512×512 | Linux AppImage + deb |
+| `assets/icon.ico` | multi-size | Windows NSIS Installer |
+| `assets/icon.icns` | multi-size | macOS (optional) |
+
+**PNG → ICO konvertieren (Linux):**
+```bash
+sudo apt install imagemagick
+convert assets/icon.png -resize 256x256 assets/icon.ico
+```
+
+**PNG → ICNS (macOS):**
+```bash
+# mit electron-icon-maker:
+npx electron-icon-maker --input=assets/icon.png --output=assets/
+```
+
+## Abhängigkeit: virt-viewer
+
+Der Client startet `remote-viewer` (Teil von virt-viewer). Muss auf dem Zielrechner installiert sein:
+
+- **Linux:** `sudo apt install virt-viewer`
+- **Windows:** https://virt-manager.org/download/ → "Windows MSI"
+
+Die App zeigt beim ersten Verbindungsversuch einen Dialog wenn `remote-viewer` nicht gefunden wird.
+
+## Verzeichnisstruktur
+
+```
+proxmox-spice-client/
+├── src/
+│   ├── main.js          # Electron-Hauptprozess
+│   ├── preload.js       # Context-Bridge
+│   ├── proxmox.js       # Proxmox REST API Client
+│   └── renderer/
+│       ├── login.html
+│       ├── login.js
+│       ├── vms.html
+│       ├── vms.js
+│       └── styles.css
+├── assets/
+│   ├── icon.png         # Quell-Icon (mind. 512×512)
+│   ├── icon.ico         # Windows
+│   └── icon.icns        # macOS (optional)
+├── daten/               # persistente Einstellungen (Docker-Mount)
+├── Dockerfile
+├── docker-compose.yml
+├── .env.example
+├── package.json
+└── BUILD.md
+```