release: v0.9.1-beta12

CHANGELOG.md

@@ -0,0 +1,132 @@
+# Changelog
+
+## [0.9.1-beta12] – 2026-04-25
+
+### Fixes
+- Fehlermeldung bei falschen MQTT-Zugangsdaten ist jetzt verständlich: `Falsche MQTT-Zugangsdaten (falscher Benutzername, Passwort oder Device-ID)` statt kryptischem `CONNACK failed: 20020005`
+
+---
+
+## [0.9.1-beta11] – 2026-04-25
+
+### Fixes
+- Drucker-IP wird automatisch bereinigt wenn der Nutzer versehentlich den Port miteingibt (z.B. `192.168.1.102:9883` → `192.168.1.102`)
+- Settings-Modal: Hinweis erscheint wenn ein `:` in der IP erkannt wird
+- `docker-compose.yml`: `.env` wird als Volume in den Container gemountet – Einstellungen bleiben nach `docker-compose restart` erhalten
+
+---
+
+## [0.9.1-beta10] – 2026-04-25
+
+### Neu
+- `start.sh` – startet die Bridge per Docker, baut das Image automatisch beim ersten Aufruf
+- Tests: pytest-Suite (19 Tests) für API-State, Moonraker-Endpunkte, Settings; Installations-Smoke-Test (`test_install.sh`)
+- Settings-Modal öffnet sich beim ersten Start automatisch wenn keine Zugangsdaten hinterlegt sind
+
+### Geändert
+- README (DE + EN): Schnellstart zeigt jetzt `./start.sh` statt manuellem `docker build`
+- README: LAN-Modus korrekt als Drucker-Menüoption beschrieben (kein WLAN-Bezug)
+- README: Versionsnummer wird ab jetzt automatisch bei jedem Release aktualisiert
+- `extract_credentials`: kein `--write-env` mehr empfohlen – Werte im ⚙-Menü eintragen
+- Dockerfile im Release-Repo: Pfade ohne `05_scripts/`-Präfix (direkt aus Repo-Root)
+- `release.sh`: Dockerfile für Release-Repo automatisch per `sed` angepasst
+
+### Fixes
+- Restdruckzeit (`remain_time`) wird jetzt korrekt aus `print/report` übernommen und in der UI angezeigt
+- Übersetzung: „Schrittweite" und „Ziel"-Placeholder in Temperatureingaben werden jetzt korrekt übersetzt
+
+---
+
+## [0.9.1-beta9] – 2026-04-25
+
+### Neu
+- OrcaSlicer-Profil (`kobra_x_orcaslicer_preset.zip`) als Release-Asset
+- `release.sh`: OrcaSlicer-Profil wird automatisch ins Release-Repo kopiert und hochgeladen
+
+### Geändert
+- README: `extract_credentials` ohne `--write-env`, Werte manuell ins ⚙-Menü eintragen
+- README: Docker-Schnellstart vereinfacht (kein `.env` anlegen vor dem Start nötig)
+
+---
+
+## [0.9.1-beta8] – 2026-04-25
+
+### Neu
+- Restdruckzeit-Anzeige in der UI (≈ Xh Ym verbleibend) aus `remain_time`-Feld des Druckers
+- Settings-Modal: Verbindungseinstellungen und Self-Update direkt im Browser
+- Self-Update: Bridge prüft Gitea-Release-API auf neue Versionen und aktualisiert sich selbst
+
+### Geändert
+- Bridge startet im Offline-Modus wenn Drucker nicht erreichbar (kein Absturz)
+- Verbinden/Trennen-Button im Header
+
+---
+
+## [0.9.1-beta7] – 2026-04-22
+
+### Neu
+- Offline-Start: Bridge läuft auch ohne MQTT-Verbindung, verbindet automatisch sobald Drucker erreichbar
+- Verbinden/Trennen-Button im Header
+
+---
+
+## [0.9.1-beta6] – 2026-04-20
+
+### Neu
+- Release-ZIPs: `kx-bridge-linux.zip`, `kx-bridge-windows.zip`, `anycubic-certs.zip` mit Zertifikaten
+
+### Fixes
+- PyInstaller frozen-Binary: `__file__` durch `sys.executable`-Pfad ersetzt (Cert-Pfad-Fix)
+
+---
+
+## [0.9.1-beta5] – 2026-04-19
+
+### Neu
+- `kx-bridge.exe` (Windows) wird automatisch via GitHub Actions gebaut
+
+---
+
+## [0.9.1-beta4] – 2026-04-18
+
+### Neu
+- `release.sh`: baut Linux-Binary und Windows-EXE, lädt alle Assets auf Gitea hoch
+- Englische README (`README.en.md`)
+
+### Fixes
+- `progress` und `filename` werden bei `stoped`/`canceled` korrekt auf 0 zurückgesetzt
+
+---
+
+## [0.9.1-beta3] – 2026-04-17
+
+### Neu
+- Print-Speed-Card (Leise / Normal / Sport)
+- Übersetzungen (DE/EN) vervollständigt
+
+---
+
+## [0.9.1-beta2] – 2026-04-17
+
+### Fixes
+- Temperatursteuerung während eines laufenden Drucks
+
+---
+
+## [0.9.1-beta1] – 2026-04-17
+
+### Neu
+- UI-Komplettüberarbeitung: Settings-Modal, Self-Update, Dashboard, Responsive Design
+- Neue Drucker-Zustände: `pausing`, `paused`, `resuming`, `resumed`, `stopping`
+- `release.sh`: Version-Bump und Release-Sync Skript
+
+---
+
+## [0.9.0-beta1] – 2026-04-10
+
+### Neu
+- Erster öffentlicher Release
+- Docker-Deployment, Linux-Binary, `extract_credentials`-Tool
+- Moonraker-kompatible HTTP/WebSocket-Bridge für den Anycubic Kobra X
+- AMS Einziehen/Ausziehen, Licht- und Lüftersteuerung
+- Web-UI mit Dashboard, Temperaturkarten, Achsensteuerung

Dockerfile

@@ -2,12 +2,15 @@ FROM python:3.11-slim
 
 WORKDIR /app
 
-COPY 05_scripts/requirements.txt .
+COPY requirements.txt .
+RUN apt-get update && apt-get install -y --no-install-recommends ffmpeg && rm -rf /var/lib/apt/lists/*
 RUN pip install --no-cache-dir -r requirements.txt
 
-COPY 05_scripts/kobrax_moonraker_bridge.py .
-COPY 05_scripts/env_loader.py .
-COPY 05_scripts/kobrax_client.py .
+COPY kobrax_moonraker_bridge.py .
+COPY env_loader.py .
+COPY kobrax_client.py .
+COPY anycubic_slicer.crt .
+COPY anycubic_slicer.key .
 
 EXPOSE 7125
 

README.en.md

@@ -1,6 +1,6 @@
 # KX-Bridge – Anycubic Kobra X Moonraker Bridge
 
-**Version:** 0.9.1-beta5  
+**Version:** 0.9.1-beta10
 **Status:** Public Beta – suitable for home users, feedback welcome
 
 KX-Bridge is a Moonraker-compatible HTTP/WebSocket bridge for the **Anycubic Kobra X** 3D printer. It allows you to control the printer through OrcaSlicer and other Moonraker-compatible software — no Klipper, no Raspberry Pi required.
@@ -24,7 +24,7 @@ KX-Bridge is a Moonraker-compatible HTTP/WebSocket bridge for the **Anycubic Kob
 
 ## Requirements
 
-- Anycubic Kobra X on your local network (LAN, no Wi-Fi client isolation)
+- Anycubic Kobra X on your local network, with **LAN mode enabled** (printer menu → enable LAN mode)
 - Printer MQTT credentials (→ see [Extracting credentials](#extracting-credentials))
 - Docker **or** Python 3.9+ **or** the pre-built Linux binary
 
@@ -33,24 +33,28 @@ KX-Bridge is a Moonraker-compatible HTTP/WebSocket bridge for the **Anycubic Kob
 ## Quick start – Docker (recommended)
 
 ```bash
-# 1. Create .env
-cp .env.example .env
-# Fill in your printer data (→ extract_credentials)
+# 1. Start the bridge
+./start.sh
+```
 
-# 2. Start the bridge
-docker compose up -d
+`start.sh` builds the Docker image automatically on first run and starts the bridge.
+
+```
+# 2. Open the web UI: http://BRIDGE-IP:7125
+#    → Settings (⚙) open automatically on first start
+#    → Enter your credentials (→ see Extracting credentials)
 
 # 3. In OrcaSlicer: add printer → "Moonraker" → http://BRIDGE-IP:7125
 ```
 
 Check logs:
 ```bash
-docker compose logs -f
+docker-compose logs -f
 ```
 
-Update:
+Stop:
 ```bash
-docker compose pull && docker compose up -d
+docker-compose down
 ```
 
 ---
@@ -59,11 +63,11 @@ docker compose pull && docker compose up -d
 
 ```bash
 chmod +x kx-bridge
-./kx-bridge --printer-ip 192.168.x.x --username userXXXX --password XXXXX \
-            --device-id XXXXX --mode-id 20030
+./kx-bridge
 ```
 
-Or place a `.env` file in the same directory — the bridge reads it automatically.
+Open the web UI: `http://localhost:7125`  
+→ Settings (⚙) open automatically and guide you through the initial setup.
 
 ---
 
@@ -71,32 +75,31 @@ Or place a `.env` file in the same directory — the bridge reads it automatical
 
 ```bash
 pip install aiohttp
-python kobrax_moonraker_bridge.py --printer-ip 192.168.x.x ...
-# Or fill in .env and start without arguments
 python kobrax_moonraker_bridge.py
 ```
 
+Open the web UI: `http://localhost:7125`  
+→ Settings (⚙) open automatically on first start.
+
 ---
 
 ## Extracting credentials
 
 The MQTT credentials are printer-specific and are generated on first connection with AnycubicSlicerNext. The `extract_credentials` tool reads them from the memory of the running slicer.
 
-**Requirement:** AnycubicSlicerNext must be running and connected to the printer.
+**Requirement:** AnycubicSlicerNext must be running and connected to the printer (printer status is shown).
 
 ### Windows
 
 ```
-extract_credentials.exe --write-env
+extract_credentials.exe
 ```
 
-Writes the found credentials directly to `.env`.
-
 ### Linux
 
 ```bash
 chmod +x extract_credentials
-./extract_credentials --write-env
+./extract_credentials
 ```
 
 ### Output
@@ -114,10 +117,13 @@ chmod +x extract_credentials
   Device-ID     xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx  (hits: 3504)
   Printer IP    192.168.x.x  (hits: 3036)
 =======================================================
-
-Hint: pass --write-env to save credentials to '.env'.
 ```
 
+Enter the displayed values in the bridge settings:  
+Open web UI → **⚙ Settings** → fill in the fields → **Save & Restart**
+
+> If the result looks uncertain: `--verbose` shows all found candidates.
+
 All credentials are **processed locally only** — nothing is sent to external servers.
 
 ---

README.md

@@ -1,25 +1,9 @@
-# KX-Bridge
+# KX-Bridge – Anycubic Kobra X Moonraker Bridge
 
-Verbindet den Anycubic Kobra X mit OrcaSlicer – ohne Klipper, ohne Raspberry Pi.
+**Version:** 0.9.1-beta10
+**Status:** Public Beta – für Heimanwender geeignet, Feedback willkommen
 
-KX-Bridge läuft auf deinem PC oder NAS und stellt eine Moonraker-kompatible Schnittstelle bereit, über die OrcaSlicer den Drucker direkt steuern kann: Druckstart, Temperatur, Fortschritt, Pause/Fortsetzen/Abbrechen, AMS-Farbwechsel, Druckgeschwindigkeit und mehr.
-
-**Version:** 0.9.1-beta5
-
----
-
-## Enthaltene Dateien
-
-| Datei | Beschreibung |
-|-------|-------------|
-| `kobrax_moonraker_bridge.py` | Bridge-Hauptprogramm |
-| `kx-bridge` | Vorkompilierte Linux-Binary |
-| `extract_credentials.exe` | Zugangsdaten aus AnycubicSlicerNext auslesen (Windows) |
-| `extract_credentials` | Zugangsdaten aus AnycubicSlicerNext auslesen (Linux) |
-| `kobra_x_orcaslicer_preset.zip` | OrcaSlicer-Druckerprofil für den Kobra X |
-| `bridge.sh` | Service-Manager für Linux |
-| `Dockerfile` / `docker-compose.yml` | Docker-Deployment |
-| `.env.example` | Konfigurationsvorlage |
+KX-Bridge ist eine Moonraker-kompatible HTTP/WebSocket-Bridge für den **Anycubic Kobra X** 3D-Drucker. Sie ermöglicht die Steuerung des Druckers über OrcaSlicer und andere Moonraker-kompatible Software, ohne dass Klipper oder ein Raspberry Pi benötigt wird.
 
 ---
 
@@ -40,93 +24,135 @@ KX-Bridge läuft auf deinem PC oder NAS und stellt eine Moonraker-kompatible Sch
 
 ## Voraussetzungen
 
-- Anycubic Kobra X im LAN-Modus (Drucker muss über LAN erreichbar sein, nicht nur über Anycubic-Cloud)
-- PC, NAS oder Server im gleichen Netzwerk (Windows oder Linux)
-- Docker oder Python 3.9+
-- MQTT-Zugangsdaten des Druckers → [Schritt 1](#schritt-1-zugangsdaten-ermitteln)
+- Anycubic Kobra X im lokalen Netzwerk, mit aktiviertem **LAN-Modus** (Drucker-Menü → LAN-Modus einschalten)
+- MQTT-Credentials des Druckers (→ siehe [Credentials extrahieren](#credentials-extrahieren))
+- Docker **oder** Python 3.9+ **oder** direkt die Linux-Binary
 
 ---
 
-## Schnellstart
-
-### Schritt 1: Zugangsdaten ermitteln
-
-Die Bridge benötigt druckerspezifische MQTT-Zugangsdaten.
-
-> **Wichtig:** Der Drucker muss sich im LAN-Modus befinden. Nur wenn der Drucker direkt über LAN (nicht ausschließlich über die Anycubic-Cloud) erreichbar ist, können die Zugangsdaten ermittelt und die Bridge genutzt werden.
-
-AnycubicSlicerNext starten und mit dem Drucker verbinden (bis der Drucker-Status angezeigt wird), dann:
-
-**Windows:**
-```
-extract_credentials.exe --write-env
-```
-
-**Linux:**
-```bash
-chmod +x extract_credentials
-./extract_credentials --write-env
-```
-
-Die Zugangsdaten werden automatisch in `.env` gespeichert.
-
-> Falls das Ergebnis unsicher wirkt: `--verbose` zeigt alle gefundenen Kandidaten. Den richtigen Wert manuell in `.env` eintragen.
-
----
-
-### Schritt 2: Konfiguration prüfen
+## Schnellstart – Docker (empfohlen)
 
 ```bash
-cp .env.example .env
-# .env öffnen und Werte kontrollieren
+# 1. Bridge starten
+./start.sh
+```
+
+`start.sh` baut das Docker-Image automatisch beim ersten Aufruf und startet die Bridge.
+
+```
+# 2. Web-UI öffnen: http://BRIDGE-IP:7125
+#    → Einstellungen (⚙) öffnen sich automatisch beim ersten Start
+#    → Zugangsdaten eintragen (→ siehe Credentials extrahieren)
+
+# 3. In OrcaSlicer: Drucker → "Moonraker" → http://BRIDGE-IP:7125
+```
+
+Logs prüfen:
+```bash
+docker-compose logs -f
+```
+
+Stoppen:
+```bash
+docker-compose down
 ```
 
 ---
 
-### Schritt 3: Bridge starten
+## Schnellstart – Binary (Linux)
 
-**Option A – Docker (empfohlen):**
-```bash
-docker compose up -d
-```
-Läuft im Hintergrund, startet automatisch nach Systemneustart.
-
-**Option B – Linux Binary:**
 ```bash
 chmod +x kx-bridge
 ./kx-bridge
-# Oder mit Service-Manager:
-./bridge.sh start
 ```
 
-**Option C – Python direkt:**
+Web-UI öffnen: `http://localhost:7125`  
+→ Einstellungen (⚙) öffnen sich automatisch und führen durch die Erstkonfiguration.
+
+---
+
+## Schnellstart – Python direkt
+
 ```bash
 pip install aiohttp
 python kobrax_moonraker_bridge.py
 ```
 
----
-
-### Schritt 4: OrcaSlicer-Profil installieren
-
-1. `kobra_x_orcaslicer_preset.zip` in OrcaSlicer importieren:  
-   Datei → Konfigurationen importieren → ZIP auswählen
-2. Anycubic Kobra X als Drucker auswählen
+Web-UI öffnen: `http://localhost:7125`  
+→ Einstellungen (⚙) öffnen sich automatisch beim ersten Start.
 
 ---
 
-### Schritt 5: OrcaSlicer verbinden
+## Credentials extrahieren
 
-1. Drucker-Einstellungen öffnen
+Die MQTT-Zugangsdaten sind druckerspezifisch und werden beim ersten Verbindungsaufbau mit dem AnycubicSlicerNext generiert. Das Tool `extract_credentials` liest sie aus dem RAM des laufenden Slicers aus.
+
+**Voraussetzung:** AnycubicSlicerNext muss gestartet und mit dem Drucker verbunden sein (Drucker-Status wird angezeigt).
+
+### Windows
+
+```
+extract_credentials.exe
+```
+
+### Linux
+
+```bash
+chmod +x extract_credentials
+./extract_credentials
+```
+
+### Ausgabe
+
+```
+[*] Prozess gefunden: AnycubicSlicerNext.exe (PID 1234)
+[*] 1986 Speichersegmente gelesen (738.8 MB)
+[*] Analysiere ... 100% (739 MB)
+
+=======================================================
+  ERGEBNISSE
+=======================================================
+  Username      userXXXXXXXXXX  (Treffer: 47)
+  Password      ***************  (Treffer: 1046)
+  Device-ID     xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx  (Treffer: 3504)
+  Drucker-IP    192.168.x.x  (Treffer: 3036)
+=======================================================
+```
+
+Die angezeigten Werte in die Bridge-Einstellungen übertragen:  
+Web-UI öffnen → **⚙ Einstellungen** → Felder ausfüllen → **Speichern & Neustart**
+
+> Falls das Ergebnis unsicher wirkt: `--verbose` zeigt alle gefundenen Kandidaten.
+
+Alle Credentials werden **ausschließlich lokal verarbeitet** — keine Übertragung an externe Server.
+
+---
+
+## Konfiguration (.env)
+
+```env
+PRINTER_IP=192.168.x.x       # IP des Druckers
+MQTT_PORT=9883                # Standard, nicht ändern
+MQTT_USERNAME=userXXXXXXXX   # Beginnt mit "user"
+MQTT_PASSWORD=XXXXXXXXXXXXXX  # ~15 Zeichen, gemischt
+DEVICE_ID=xxxxxxxx...         # 32-stelliger Hex-String
+MODE_ID=20030                 # Kobra X Standard
+```
+
+---
+
+## OrcaSlicer verbinden
+
+1. Drucker hinzufügen → **Anycubic Kobra X** (oder generischer Klipper-Drucker)
 2. Verbindungstyp: **Moonraker**
-3. Adresse: `http://IP-DES-BRIDGE-PC:7125` eintragen
-4. Auf „Test" klicken – bei erfolgreicher Verbindung erscheint eine Bestätigungsmeldung
+3. IP: `http://BRIDGE-HOST:7125`
+4. Verbindung testen → sollte "Online" anzeigen
 
 ---
 
 ## Web-UI
 
-Die Bridge stellt unter `http://BRIDGE-IP:7125` eine Web-Oberfläche bereit:
+Die Bridge stellt unter `http://BRIDGE-HOST:7125` eine Web-Oberfläche bereit:
 
 | Bereich | Funktion |
 |---------|----------|
@@ -136,55 +162,56 @@ Die Bridge stellt unter `http://BRIDGE-IP:7125` eine Web-Oberfläche bereit:
 | Druckgeschwindigkeit | Leise / Normal / Sport |
 | Lüfter / Licht | Lüfterdrehzahl und Drucklicht |
 | AMS | Filament einziehen / ausziehen |
-| Kamera | Live-Vorschau (falls vom Drucker unterstützt) |
+| Kamera | Live-Vorschau (falls Drucker unterstützt) |
 | ⚙ Einstellungen | MQTT-Zugangsdaten, Poll-Intervall, Self-Update |
 
 ### Self-Update
 
-Über das ⚙-Menü in der Web-UI kann die Bridge auf neue Versionen prüfen und sich selbst aktualisieren — ohne Neuinstallation. Nach dem Download startet sie automatisch neu.
+Über das ⚙-Menü in der Web-UI kann die Bridge auf neue Versionen prüfen und sich selbst aktualisieren — ohne Neuinstallation. Nach dem Download startet die Bridge automatisch mit der neuen Version neu.
 
 ---
 
-## bridge.sh – Service-Manager (Linux)
+## bridge.sh (Linux Service-Manager)
 
 ```bash
-./bridge.sh start     # Im Hintergrund starten
-./bridge.sh stop      # Beenden
-./bridge.sh restart   # Neustarten
-./bridge.sh status    # Status anzeigen
-./bridge.sh log 50    # Letzte 50 Log-Zeilen
+./bridge.sh start    # Bridge im Hintergrund starten
+./bridge.sh stop     # Bridge beenden
+./bridge.sh restart  # Neustarten
+./bridge.sh status   # Status und Port prüfen
+./bridge.sh log 50   # Letzte 50 Log-Zeilen
 ```
 
 ---
 
-## Docker – Nützliche Befehle
+## Druckerzustände
 
-```bash
-docker compose up -d                         # Starten
-docker compose down                          # Stoppen
-docker compose logs -f                       # Logs verfolgen
-docker compose pull && docker compose up -d  # Update
-```
+Die Bridge übersetzt die internen Kobra-Zustände in Moonraker-kompatible Zustände:
+
+| Kobra-Zustand | Bedeutung |
+|---------------|-----------|
+| free | Bereit |
+| printing / busy | Druckt |
+| pausing / paused | Pausiert |
+| resuming / resumed | Wird fortgesetzt |
+| stopping / stoped | Wird gestoppt |
+| finished | Abgeschlossen |
+| canceled | Abgebrochen |
+| failed | Fehler |
 
 ---
 
 ## Fehlerbehebung
 
-**Port 7125 belegt:**
+**Port 7125 bereits belegt:**
 ```bash
-./bridge.sh stop
+./bridge.sh stop    # oder: fuser -k 7125/tcp
 ./bridge.sh start
 ```
 
-**Verbindungstest in OrcaSlicer schlägt fehl:**
-- Firewall prüfen: Port 7125 muss erreichbar sein
-- Bridge-Log prüfen: `./bridge.sh log` oder `docker compose logs`
-- Drucker-IP in `.env` korrekt?
-
-**Zugangsdaten werden abgelehnt:**
-- AnycubicSlicerNext starten, mit Drucker verbinden
-- `extract_credentials --verbose` ausführen und alle Kandidaten prüfen
-- Richtigen Wert manuell in `.env` eintragen, Bridge neu starten
+**Credentials ungültig / Verbindung abgelehnt:**
+- AnycubicSlicerNext starten, mit Drucker verbinden, `extract_credentials` erneut ausführen
+- Falls das Ergebnis unsicher wirkt: `extract_credentials --verbose` zeigt alle Kandidaten an
+- Den richtigen Kandidaten manuell in `.env` eintragen und Bridge neu starten
 
 **Temperaturänderungen werden ignoriert:**
 - Während eines laufenden Drucks werden Temperaturänderungen über einen separaten Kanal gesendet — das ist normal und wird von der Bridge automatisch erkannt.
@@ -192,21 +219,26 @@ docker compose pull && docker compose up -d  # Update
 **Docker: Permission denied:**
 ```bash
 sudo usermod -aG docker $USER
-# Neu einloggen, dann erneut versuchen
+# Neu einloggen
+```
+
+**Docker: .env nicht gefunden:**
+```bash
+# .env muss im gleichen Verzeichnis wie docker-compose.yml liegen
+cp .env.example .env && nano .env
 ```
 
 ---
 
-## Konfigurationsreferenz (.env)
+## Logs
 
-| Parameter | Beschreibung | Beispiel |
-|-----------|-------------|---------|
-| `PRINTER_IP` | IP-Adresse des Druckers | `192.168.1.100` |
-| `MQTT_PORT` | MQTT-Port (nicht ändern) | `9883` |
-| `MQTT_USERNAME` | Benutzername (beginnt mit „user") | `userXXXXXXXXXX` |
-| `MQTT_PASSWORD` | Passwort (~15 Zeichen) | `***` |
-| `DEVICE_ID` | Geräte-ID (32 Hex-Zeichen) | `xxxxxxxx...` |
-| `MODE_ID` | Modell-ID (Kobra X Standard) | `20030` |
+```bash
+# Docker
+docker compose logs -f kx-bridge
+
+# Binary / Python
+tail -f /tmp/bridge.log   # bei Nutzung von bridge.sh
+```
 
 ---
 
@@ -214,14 +246,11 @@ sudo usermod -aG docker $USER
 
 - Die Bridge bindet standardmäßig auf `0.0.0.0:7125` — nur im lokalen Netzwerk nutzen
 - `.env` enthält Drucker-Credentials — nicht öffentlich teilen
-- Alle Zugangsdaten werden ausschließlich lokal verarbeitet — keine Übertragung an externe Server
+- Die Credentials sind druckerspezifisch und haben keinen Zugang zu Anycubic-Cloud-Diensten
 
 ---
 
-## Hinweis zur Nutzung
+## Lizenz & Rechtliches
 
-Dieses Projekt dient der privaten Nutzung und der Herstellung von Interoperabilität zwischen dem Anycubic Kobra X und freier Software (OrcaSlicer).
-
-`extract_credentials` liest ausschließlich den Arbeitsspeicher des auf deinem eigenen PC laufenden AnycubicSlicerNext-Prozesses. Es werden keine Daten übertragen oder gespeichert, außer in die lokale `.env`-Datei.
-
-Das Projekt steht in keiner Verbindung zu Anycubic und wird nicht kommerziell betrieben.
+Dieses Projekt entstand durch Interoperabilitätsforschung gem. §69e UrhG.  
+Ausschließlich für private, nicht-kommerzielle Nutzung.

VERSION

@@ -1 +1 @@
-0.9.1-beta7
+0.9.1-beta12

docker-compose.yml

@@ -3,6 +3,8 @@ services:
     image: kx-bridge:latest
     build: .
     env_file: .env
+    volumes:
+      - ./.env:/app/.env
     ports:
       - "7125:7125"
     restart: unless-stopped

kobrax_moonraker_bridge.py

@@ -80,6 +80,7 @@ class KobraXBridge:
             "filename":           "",
             "progress":           0.0,
             "print_duration":     0,
+            "remain_time":        0,
             "curr_layer":         0,
             "total_layers":       0,
             "printer_name":       "Anycubic Kobra X",
@@ -133,6 +134,8 @@ class KobraXBridge:
             self._state["progress"]   = float(d["progress"]) / 100.0
         if "print_time" in d:
             self._state["print_duration"] = int(d["print_time"]) * 60
+        if "remain_time" in d:
+            self._state["remain_time"] = int(d["remain_time"]) * 60
         if "curr_layer" in d:
             self._state["curr_layer"] = d["curr_layer"]
         if "total_layers" in d:
@@ -249,6 +252,7 @@ class KobraXBridge:
                 "filename":       s["filename"],
                 "print_duration": s["print_duration"],
                 "total_duration": s["print_duration"],
+                "remain_time":    s["remain_time"],
                 "info": {
                     "current_layer": s["curr_layer"],
                     "total_layer":   s["total_layers"],
@@ -593,6 +597,12 @@ header{background:var(--card);border-bottom:1px solid var(--border);
 .theme-btn{background:none;border:1px solid var(--border);color:var(--txt2);
   border-radius:8px;padding:6px 10px;cursor:pointer;font-size:13px;transition:.15s}
 .theme-btn:hover{border-color:var(--accent);color:var(--accent)}
+.conn-btn{border-radius:8px;padding:6px 12px;cursor:pointer;font-size:13px;
+  font-weight:600;border:none;transition:.15s}
+.conn-btn.disconnected{background:var(--accent);color:#fff}
+.conn-btn.disconnected:hover{opacity:.85}
+.conn-btn.connected{background:transparent;border:1px solid var(--border);color:var(--txt2)}
+.conn-btn.connected:hover{border-color:#e05;color:#e05}
 
 /* ── LAYOUT ── */
 .layout{display:flex;flex:1;min-height:0}
@@ -837,6 +847,7 @@ nav.bottom-nav{display:none;position:fixed;bottom:0;left:0;right:0;
   <button class="theme-btn" onclick="toggleTheme()">☀ / ☾</button>
   <button class="theme-btn" onclick="toggleLang()" id="lang-btn">EN</button>
   <button class="theme-btn" onclick="openSettings()" id="settings-btn" title="Einstellungen">⚙</button>
+  <button class="conn-btn disconnected" id="conn-btn" onclick="toggleConnection()">⚡ Verbinden</button>
 </header>
 
 <!-- ═══ SETTINGS MODAL ═══ -->
@@ -852,6 +863,7 @@ nav.bottom-nav{display:none;position:fixed;bottom:0;left:0;right:0;
       <div class="modal-field">
         <label id="lbl-printer-ip">Drucker-IP</label>
         <input type="text" id="s-printer-ip" placeholder="192.168.x.x">
+        <small id="lbl-ip-hint" style="color:#f80;display:none"></small>
       </div>
       <div class="modal-field">
         <label id="lbl-mqtt-port">MQTT-Port</label>
@@ -944,6 +956,7 @@ nav.bottom-nav{display:none;position:fixed;bottom:0;left:0;right:0;
           <div class="progress-bar" style="margin:8px 0"><div class="progress-fill" id="d-pbar" style="width:0%"></div></div>
           <div class="meta-row" style="margin-top:6px">
             <span id="d-elapsed">–</span>
+            <span id="d-remain" style="color:var(--acc)">–</span>
             <span id="d-layers" class="layer-badge">–</span>
           </div>
           <div class="fname" id="d-fname" title="" style="margin-top:6px">–</div>
@@ -1030,7 +1043,7 @@ nav.bottom-nav{display:none;position:fixed;bottom:0;left:0;right:0;
             <button class="joy" onclick="move(2,-1,getStep())" title="Z−">▲</button>
             <button class="joy" onclick="move(2,1,getStep())" title="Z+">▼</button>
           </div>
-          <div style="text-align:center;margin-top:8px;font-size:12px;color:var(--txt2)">Schrittweite: <span id="step-display">1</span> mm</div>
+          <div style="text-align:center;margin-top:8px;font-size:12px;color:var(--txt2)"><span class="lbl-step">Schrittweite:</span> <span id="step-display">1</span> mm</div>
         </div>
 
         <!-- Print Speed -->
@@ -1112,7 +1125,7 @@ nav.bottom-nav{display:none;position:fixed;bottom:0;left:0;right:0;
 <script>
 // ── State ──
 var S={nozzle_temp:0,nozzle_target:0,bed_temp:0,bed_target:0,
-  print_state:'standby',filename:'',progress:0,print_duration:0,
+  print_state:'standby',filename:'',progress:0,print_duration:0,remain_time:0,
   curr_layer:0,total_layers:0,printer_name:'Kobra X',firmware_version:'–',
   camera_url:'',fan_speed:0,print_speed_mode:2,light_on:false,light_brightness:80,ams_slots:[]};
 var tempHistory={n:[],b:[]};
@@ -1133,7 +1146,7 @@ var LANG_DE={
   header_status_standby:'Bereit',header_status_printing:'Druckt',header_status_complete:'Fertig',header_status_error:'Fehler',
   kobra_free:'Bereit',kobra_busy:'Beschäftigt',kobra_printing:'Druckt',kobra_preheating:'Aufheizen',kobra_auto_leveling:'Nivellierung',kobra_checking:'Prüfung',kobra_updated:'Aktualisierung',kobra_init:'Initialisierung',kobra_pausing:'Pausiert...',kobra_paused:'Pausiert',kobra_resuming:'Fortsetzen...',kobra_resumed:'Fortgesetzt',kobra_stopping:'Stoppt...',kobra_stoped:'Gestoppt',kobra_finished:'Abgeschlossen',kobra_failed:'Fehler',kobra_canceled:'Abgebrochen',kobra_offline:'Offline',
   nav_dashboard:'Dashboard',nav_print:'Druck',nav_temps:'Temperaturen',nav_motion:'Achsen',nav_ams:'AMS',nav_extras:'Licht / Lüfter',nav_console:'Konsole',
-  card_progress:'Fortschritt',card_temps:'Temperaturen',card_light_fan:'Lüfter',card_speed:'Druckgeschwindigkeit',card_cam:'Kamera',
+  card_progress:'Fortschritt',card_temps:'Temperaturen',card_light_fan:'Lüfter',card_speed:'Druckgeschwindigkeit',card_cam:'Kamera',lbl_elapsed:'Verstrichen',lbl_remaining:'verbleibend',
   speed_silent:'🐢 Leise',speed_normal:'⚡ Normal',speed_sport:'🚀 Sport',
   lbl_light:'💡 Licht',lbl_feed:'Einziehen',lbl_unload:'Ausziehen',
   cam_placeholder:'📷 Kamera nicht gestartet',btn_cam_start:'▶ Kamera',btn_cam_stop:'◼ Kamera',
@@ -1150,15 +1163,16 @@ var LANG_DE={
   confirm_cancel:'Druck wirklich abbrechen?',
   settings_title:'Einstellungen',settings_connection:'Verbindung',settings_poll:'Poll-Intervall',settings_version:'Version',
   settings_save:'Speichern & Neustart',settings_printer_ip:'Drucker-IP',settings_mqtt_port:'MQTT-Port',
-  settings_username:'MQTT-Benutzername',settings_password:'MQTT-Passwort',settings_device_id:'Device-ID',settings_mode_id:'Mode-ID',
+  settings_username:'MQTT-Benutzername',settings_password:'MQTT-Passwort',settings_device_id:'Device-ID',settings_mode_id:'Mode-ID',hint_ip_no_port:'Nur IP-Adresse, kein Port (z.B. 192.168.1.102)',
   update_check:'Auf Updates prüfen',update_checking:'Prüfe...',update_available:'verfügbar',update_none:'Bereits aktuell',
-  update_apply:'Jetzt installieren',update_applying:'Lade herunter...',update_restarting:'Starte neu...',update_error:'Fehler'
+  update_apply:'Jetzt installieren',update_applying:'Lade herunter...',update_restarting:'Starte neu...',update_error:'Fehler',
+  btn_connect:'⚡ Verbinden',btn_disconnect:'✕ Trennen'
 };
 var LANG_EN={
   header_status_standby:'Ready',header_status_printing:'Printing',header_status_complete:'Complete',header_status_error:'Error',
   kobra_free:'Ready',kobra_busy:'Busy',kobra_printing:'Printing',kobra_preheating:'Preheating',kobra_auto_leveling:'Auto Leveling',kobra_checking:'Checking',kobra_updated:'Updating',kobra_init:'Initializing',kobra_pausing:'Pausing...',kobra_paused:'Paused',kobra_resuming:'Resuming...',kobra_resumed:'Resumed',kobra_stopping:'Stopping...',kobra_stoped:'Stopped',kobra_finished:'Finished',kobra_failed:'Error',kobra_canceled:'Cancelled',kobra_offline:'Offline',
   nav_dashboard:'Dashboard',nav_print:'Print',nav_temps:'Temperatures',nav_motion:'Motion',nav_ams:'AMS',nav_extras:'Light / Fan',nav_console:'Console',
-  card_progress:'Progress',card_temps:'Temperatures',card_light_fan:'Fan',card_speed:'Print Speed',card_cam:'Camera',
+  card_progress:'Progress',card_temps:'Temperatures',card_light_fan:'Fan',card_speed:'Print Speed',card_cam:'Camera',lbl_elapsed:'Elapsed',lbl_remaining:'remaining',
   speed_silent:'🐢 Silent',speed_normal:'⚡ Normal',speed_sport:'🚀 Sport',
   lbl_light:'💡 Light',lbl_feed:'Load',lbl_unload:'Unload',
   cam_placeholder:'📷 Camera not started',btn_cam_start:'▶ Camera',btn_cam_stop:'◼ Camera',
@@ -1175,9 +1189,10 @@ var LANG_EN={
   confirm_cancel:'Really cancel the print?',
   settings_title:'Settings',settings_connection:'Connection',settings_poll:'Poll Interval',settings_version:'Version',
   settings_save:'Save & Restart',settings_printer_ip:'Printer IP',settings_mqtt_port:'MQTT Port',
-  settings_username:'MQTT Username',settings_password:'MQTT Password',settings_device_id:'Device ID',settings_mode_id:'Mode ID',
+  settings_username:'MQTT Username',settings_password:'MQTT Password',settings_device_id:'Device ID',settings_mode_id:'Mode ID',hint_ip_no_port:'IP address only, no port (e.g. 192.168.1.102)',
   update_check:'Check for Updates',update_checking:'Checking...',update_available:'available',update_none:'Already up to date',
-  update_apply:'Install Now',update_applying:'Downloading...',update_restarting:'Restarting...',update_error:'Error'
+  update_apply:'Install Now',update_applying:'Downloading...',update_restarting:'Restarting...',update_error:'Error',
+  btn_connect:'⚡ Connect',btn_disconnect:'✕ Disconnect'
 };
 var currentLang='de';
 var T=LANG_DE;
@@ -1223,6 +1238,7 @@ function applyLang(){
   document.querySelectorAll('.lbl-home-z').forEach(e=>e.textContent=T.btn_home_z);
   document.querySelectorAll('.lbl-home-all').forEach(e=>e.textContent=T.btn_home_all);
   document.querySelectorAll('.lbl-step').forEach(e=>e.textContent=T.label_step);
+  document.querySelectorAll('.temp-input').forEach(e=>e.setAttribute('placeholder',T.label_target_c.replace(':','')));
   // Console
   setText('ptitle-console',T.panel_console_title);
   // Settings modal
@@ -1246,6 +1262,8 @@ function applyLang(){
   // AMS feed/unload
   document.querySelectorAll('.lbl-feed').forEach(e=>e.textContent=T.lbl_feed);
   document.querySelectorAll('.lbl-unload').forEach(e=>e.textContent=T.lbl_unload);
+  // conn-btn text (nur wenn nicht im Übergangszustand)
+  updateConnBtn();
 }
 function setText(id,txt){var el=document.getElementById(id);if(el)el.textContent=txt;}
 (function(){
@@ -1254,7 +1272,13 @@ function setText(id,txt){var el=document.getElementById(id);if(el)el.textContent
   document.getElementById('lang-btn').textContent=l==='de'?'EN':'DE';
   document.documentElement.setAttribute('lang',l);
   // defer until DOM ready
-  window.addEventListener('DOMContentLoaded',function(){applyLang();});
+  window.addEventListener('DOMContentLoaded',function(){
+    applyLang();
+    // Beim ersten Start (keine Zugangsdaten) Settings-Modal automatisch öffnen
+    fetch('/api/settings').then(function(r){return r.json()}).then(function(d){
+      if(!d.printer_ip||!d.device_id)openSettings();
+    }).catch(function(){});
+  });
 })();
 
 // ── Panel nav ──
@@ -1313,6 +1337,8 @@ function applyState(){
 
   var elapsed=fmtTime(s.print_duration);
   var delapsed=document.getElementById('d-elapsed');if(delapsed)delapsed.textContent=elapsed;
+  var remain=s.remain_time>0?'≈ '+fmtTime(s.remain_time)+' '+T.lbl_remaining:'';
+  var dremain=document.getElementById('d-remain');if(dremain)dremain.textContent=remain;
 
   var fn=s.filename||'–';
   var dfname=document.getElementById('d-fname');if(dfname){dfname.textContent=fn;dfname.title=fn};
@@ -1371,6 +1397,33 @@ function applyState(){
   if(s.print_state==='printing'&&!camOn&&s.camera_url){
     camStart();
   }
+
+  updateConnBtn();
+}
+
+function updateConnBtn(){
+  var btn=document.getElementById('conn-btn');
+  if(!btn)return;
+  var offline=S.kobra_state==='offline';
+  if(offline){
+    btn.className='conn-btn disconnected';
+    btn.textContent=T.btn_connect||'⚡ Verbinden';
+  } else {
+    btn.className='conn-btn connected';
+    btn.textContent=T.btn_disconnect||'✕ Trennen';
+  }
+}
+
+function toggleConnection(){
+  var btn=document.getElementById('conn-btn');
+  var offline=S.kobra_state==='offline';
+  btn.disabled=true;
+  btn.textContent='…';
+  var url=offline?'/api/connect':'/api/disconnect';
+  post(url,{}).then(function(r){return r.json()}).then(function(r){
+    btn.disabled=false;
+    if(r.error)addLog('Error: '+r.error);
+  }).catch(function(){btn.disabled=false;});
 }
 
 // ── Temp history + chart ──
@@ -1426,6 +1479,13 @@ function openSettings(){
 function closeSettings(){
   document.getElementById('settings-modal').classList.remove('open');
 }
+document.addEventListener('DOMContentLoaded',function(){
+  document.getElementById('s-printer-ip').addEventListener('input',function(){
+    var hint=document.getElementById('lbl-ip-hint');
+    if(this.value.includes(':')){hint.textContent=T.hint_ip_no_port;hint.style.display='block';}
+    else{hint.style.display='none';}
+  });
+});
 function setPoll(ms){
   document.querySelectorAll('.poll-btn').forEach(function(b){b.classList.remove('active')});
   var id='poll-'+Math.round(ms/1000);
@@ -1685,6 +1745,28 @@ function toggleCam(){if(camOn)camStop();else camStart()}
         self._state["fan_speed"] = speed
         return web.json_response({"result": "ok"})
 
+    async def handle_api_connect(self, request):
+        loop = asyncio.get_event_loop()
+        try:
+            await loop.run_in_executor(None, self.client.connect)
+            self._state["print_state"] = "standby"
+            self._state["kobra_state"] = "free"
+            log.info("Manuell verbunden")
+            return web.json_response({"result": "connected"})
+        except Exception as e:
+            return web.json_response({"error": str(e)}, status=500)
+
+    async def handle_api_disconnect(self, request):
+        loop = asyncio.get_event_loop()
+        try:
+            await loop.run_in_executor(None, self.client.disconnect)
+        except Exception:
+            pass
+        self._state["print_state"] = "error"
+        self._state["kobra_state"] = "offline"
+        log.info("Manuell getrennt")
+        return web.json_response({"result": "disconnected"})
+
     async def handle_api_speed(self, request):
         try:
             body = await request.json()
@@ -1894,6 +1976,7 @@ function toggleCam(){if(camOn)camStop();else camStart()}
             "bed_target":       s["bed_target"],
             "progress":         s["progress"],
             "print_duration":   s["print_duration"],
+            "remain_time":      s["remain_time"],
             "curr_layer":       s["curr_layer"],
             "total_layers":     s["total_layers"],
             "filename":         s["filename"],
@@ -1993,7 +2076,7 @@ function toggleCam(){if(camOn)camStop();else camStart()}
                 lines.append(line)
         # Werte aktualisieren
         mapping = {
-            "PRINTER_IP":    str(data.get("printer_ip",  existing.get("PRINTER_IP",  ""))),
+            "PRINTER_IP":    str(data.get("printer_ip",  existing.get("PRINTER_IP",  ""))).split(":")[0],
             "MQTT_PORT":     str(data.get("mqtt_port",   existing.get("MQTT_PORT",   "9883"))),
             "MQTT_USERNAME": str(data.get("username",    existing.get("MQTT_USERNAME",""))),
             "MQTT_PASSWORD": str(data.get("password",    existing.get("MQTT_PASSWORD",""))),
@@ -2267,7 +2350,7 @@ function toggleCam(){if(camOn)camStop();else camStart()}
             return False
 
     def _poll_loop(self, stop_event: threading.Event):
-        _offline = False          # True = Drucker zuletzt nicht erreichbar
+        _offline = self._state["kobra_state"] == "offline"
         _probe_interval = 10.0   # Sekunden zwischen TCP-Probes im Offline-Modus
 
         while not stop_event.is_set():
@@ -2282,7 +2365,7 @@ function toggleCam(){if(camOn)camStop();else camStart()}
                         self._state["kobra_state"] = "free"
                         log.info("MQTT-Verbindung wiederhergestellt")
                     except Exception as e:
-                        log.warning(f"Verbindungsaufbau fehlgeschlagen: {e}")
+                        log.warning(f"Verbindungsaufbau fehlgeschlagen: {_mqtt_error_msg(e)}")
                         stop_event.wait(_probe_interval)
                         continue
                 else:
@@ -2325,6 +2408,13 @@ function toggleCam(){if(camOn)camStop();else camStart()}
 # App factory + main
 # ---------------------------------------------------------------------------
 
+def _mqtt_error_msg(exc: Exception) -> str:
+    msg = str(exc)
+    if "20020005" in msg:
+        return "Falsche MQTT-Zugangsdaten (falscher Benutzername, Passwort oder Device-ID)"
+    return msg
+
+
 def build_app(bridge: KobraXBridge) -> web.Application:
     app = web.Application()
     r = app.router
@@ -2355,6 +2445,8 @@ def build_app(bridge: KobraXBridge) -> web.Application:
     # New API endpoints
     r.add_post("/api/light",               bridge.handle_api_light)
     r.add_post("/api/fan",                 bridge.handle_api_fan)
+    r.add_post("/api/connect",             bridge.handle_api_connect)
+    r.add_post("/api/disconnect",          bridge.handle_api_disconnect)
     r.add_post("/api/speed",               bridge.handle_api_speed)
     r.add_post("/api/ams/feed",            bridge.handle_api_ams_feed)
     r.add_post("/api/axis",                bridge.handle_api_axis)
@@ -2384,7 +2476,6 @@ def build_app(bridge: KobraXBridge) -> web.Application:
 
 
 async def run_bridge(args):
-    log.info(f"Verbinde mit Drucker {args.printer_ip}:{args.mqtt_port} …")
     client = KobraXClient(
         host=args.printer_ip,
         port=args.mqtt_port,
@@ -2395,11 +2486,18 @@ async def run_bridge(args):
         client_id="kobrax_bridge",
     )
 
-    loop = asyncio.get_event_loop()
-    await loop.run_in_executor(None, client.connect)
-    log.info("MQTT verbunden")
-
     bridge  = KobraXBridge(client, args=args)
+
+    # Verbindungsversuch beim Start – bei Fehler im Offline-Modus weiterlaufen
+    loop = asyncio.get_event_loop()
+    log.info(f"Verbinde mit Drucker {args.printer_ip}:{args.mqtt_port} …")
+    try:
+        await loop.run_in_executor(None, client.connect)
+        log.info("MQTT verbunden")
+    except Exception as e:
+        log.warning(f"Verbindung fehlgeschlagen: {_mqtt_error_msg(e)} – starte im Offline-Modus")
+        bridge._state["print_state"] = "error"
+        bridge._state["kobra_state"] = "offline"
     app     = build_app(bridge)
 
     stop_event = threading.Event()
@@ -2443,6 +2541,8 @@ def main():
     parser.add_argument("--port",        type=int, default=7125,
                         help="HTTP/WS-Port (Moonraker-Standard: 7125)")
     args = parser.parse_args()
+    if args.printer_ip and ":" in args.printer_ip:
+        args.printer_ip = args.printer_ip.split(":")[0]
 
     asyncio.run(run_bridge(args))
 

start.sh

@@ -0,0 +1,67 @@
+#!/usr/bin/env bash
+# start.sh – KX-Bridge starten (baut Docker-Image automatisch wenn nötig)
+
+set -euo pipefail
+
+cd "$(dirname "$0")"
+
+# .env anlegen falls nicht vorhanden
+if [[ ! -f .env ]]; then
+    if [[ -f .env.example ]]; then
+        cp .env.example .env
+        echo "[start] .env aus .env.example erstellt"
+    else
+        touch .env
+    fi
+fi
+
+# Docker verfügbar?
+if ! docker info > /dev/null 2>&1; then
+    echo "[start] Docker nicht gefunden – bitte Docker installieren."
+    exit 1
+fi
+
+# Prüfen ob Build nötig ist
+NEEDS_BUILD=0
+if ! docker image inspect kx-bridge:latest > /dev/null 2>&1; then
+    echo "[start] Image nicht vorhanden – baue kx-bridge:latest ..."
+    NEEDS_BUILD=1
+else
+    # Image-Erstellungszeit in Unix-Sekunden
+    IMAGE_TS=$(docker inspect --format='{{.Created}}' kx-bridge:latest \
+        | python3 -c "import sys,datetime; s=sys.stdin.read().strip(); \
+          s=s[:26].rstrip('Z').replace('T',' '); \
+          print(int(datetime.datetime.fromisoformat(s).replace(tzinfo=datetime.timezone.utc).timestamp()))" 2>/dev/null || echo 0)
+
+    for f in Dockerfile \
+              05_scripts/kobrax_moonraker_bridge.py \
+              05_scripts/kobrax_client.py \
+              05_scripts/env_loader.py \
+              05_scripts/requirements.txt \
+              05_scripts/anycubic_slicer.crt \
+              05_scripts/anycubic_slicer.key; do
+        if [[ -f "$f" ]]; then
+            FILE_TS=$(python3 -c "import os; print(int(os.path.getmtime('$f')))" 2>/dev/null || echo 0)
+            if [[ $FILE_TS -gt $IMAGE_TS ]]; then
+                echo "[start] '$f' ist neuer als das Image – baue neu ..."
+                NEEDS_BUILD=1
+                break
+            fi
+        fi
+    done
+fi
+
+if [[ $NEEDS_BUILD -eq 1 ]]; then
+    docker build -t kx-bridge:latest .
+fi
+
+# Container starten
+echo "[start] Starte KX-Bridge ..."
+docker-compose down 2>/dev/null || true
+docker-compose up -d
+
+echo ""
+echo "  ✓ KX-Bridge läuft"
+echo "  Web-UI : http://$(hostname -I | awk '{print $1}'):7125"
+echo "  Logs   : docker-compose logs -f"
+echo "  Stop   : docker-compose down"