release: v0.9.1-beta6

README.en.md

@@ -0,0 +1,250 @@
+# KX-Bridge – Anycubic Kobra X Moonraker Bridge
+
+**Version:** 0.9.1-beta5  
+**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.
+
+---
+
+## What's supported?
+
+- Printer status (temperature, progress, state)
+- File transfer and print start
+- Print control: pause, resume, cancel
+- Temperature control during an active print
+- Print speed (Silent / Normal / Sport)
+- AMS filament change (load / unload)
+- Light and fan control
+- Web UI with dashboard, temperature cards, axis control, and camera view
+- Settings and self-update directly in the browser (⚙ menu)
+- OrcaSlicer connection (Moonraker protocol)
+
+---
+
+## Requirements
+
+- Anycubic Kobra X on your local network (LAN, no Wi-Fi client isolation)
+- Printer MQTT credentials (→ see [Extracting credentials](#extracting-credentials))
+- Docker **or** Python 3.9+ **or** the pre-built Linux binary
+
+---
+
+## Quick start – Docker (recommended)
+
+```bash
+# 1. Create .env
+cp .env.example .env
+# Fill in your printer data (→ extract_credentials)
+
+# 2. Start the bridge
+docker compose up -d
+
+# 3. In OrcaSlicer: add printer → "Moonraker" → http://BRIDGE-IP:7125
+```
+
+Check logs:
+```bash
+docker compose logs -f
+```
+
+Update:
+```bash
+docker compose pull && docker compose up -d
+```
+
+---
+
+## Quick start – Binary (Linux)
+
+```bash
+chmod +x kx-bridge
+./kx-bridge --printer-ip 192.168.x.x --username userXXXX --password XXXXX \
+            --device-id XXXXX --mode-id 20030
+```
+
+Or place a `.env` file in the same directory — the bridge reads it automatically.
+
+---
+
+## Quick start – Python directly
+
+```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
+```
+
+---
+
+## 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.
+
+### Windows
+
+```
+extract_credentials.exe --write-env
+```
+
+Writes the found credentials directly to `.env`.
+
+### Linux
+
+```bash
+chmod +x extract_credentials
+./extract_credentials --write-env
+```
+
+### Output
+
+```
+[*] Process found: AnycubicSlicerNext.exe (PID 1234)
+[*] 1986 memory segments read (738.8 MB)
+[*] Analyzing ... 100% (739 MB)
+
+=======================================================
+  RESULTS
+=======================================================
+  Username      userXXXXXXXXXX  (hits: 47)
+  Password      ***************  (hits: 1046)
+  Device-ID     xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx  (hits: 3504)
+  Printer IP    192.168.x.x  (hits: 3036)
+=======================================================
+
+Hint: pass --write-env to save credentials to '.env'.
+```
+
+All credentials are **processed locally only** — nothing is sent to external servers.
+
+---
+
+## Configuration (.env)
+
+```env
+PRINTER_IP=192.168.x.x       # Printer IP address
+MQTT_PORT=9883                # Default, do not change
+MQTT_USERNAME=userXXXXXXXX   # Starts with "user"
+MQTT_PASSWORD=XXXXXXXXXXXXXX  # ~15 characters, mixed case
+DEVICE_ID=xxxxxxxx...         # 32-character hex string
+MODE_ID=20030                 # Kobra X default
+```
+
+---
+
+## OrcaSlicer setup
+
+1. Add printer → **Anycubic Kobra X** (or generic Klipper printer)
+2. Connection type: **Moonraker**
+3. Host: `http://BRIDGE-HOST:7125`
+4. Test connection → should show "Online"
+
+---
+
+## Web UI
+
+The bridge serves a web interface at `http://BRIDGE-HOST:7125`:
+
+| Section | Function |
+|---------|----------|
+| Dashboard | Printer status, progress, temperature overview |
+| Temperatures | Set nozzle and bed temperature directly |
+| Motion | X/Y/Z movement, motor release |
+| Print Speed | Silent / Normal / Sport |
+| Fan / Light | Fan speed and work light |
+| AMS | Load / unload filament |
+| Camera | Live preview (if supported by printer) |
+| ⚙ Settings | MQTT credentials, poll interval, self-update |
+
+### Self-update
+
+The ⚙ menu in the web UI lets you check for new versions and update the bridge in place — no reinstallation needed. After the download the bridge restarts automatically with the new version.
+
+---
+
+## bridge.sh (Linux service manager)
+
+```bash
+./bridge.sh start    # Start bridge in background
+./bridge.sh stop     # Stop bridge
+./bridge.sh restart  # Restart
+./bridge.sh status   # Check status and port
+./bridge.sh log 50   # Show last 50 log lines
+```
+
+---
+
+## Printer states
+
+The bridge translates internal Kobra states into Moonraker-compatible states:
+
+| Kobra state | Meaning |
+|-------------|---------|
+| free | Ready |
+| printing / busy | Printing |
+| pausing / paused | Paused |
+| resuming / resumed | Resuming |
+| stopping / stoped | Stopping |
+| finished | Complete |
+| canceled | Cancelled |
+| failed | Error |
+
+---
+
+## Troubleshooting
+
+**Port 7125 already in use:**
+```bash
+./bridge.sh stop    # or: fuser -k 7125/tcp
+./bridge.sh start
+```
+
+**Invalid credentials / connection refused:**
+- Start AnycubicSlicerNext, connect to the printer, then run `extract_credentials` again
+- If the result looks uncertain: `extract_credentials --verbose` shows all candidates
+- Manually enter the correct candidate in `.env` and restart the bridge
+
+**Temperature changes are ignored:**
+- During an active print, temperature changes are sent via a separate channel — this is normal and the bridge handles it automatically.
+
+**Docker: Permission denied:**
+```bash
+sudo usermod -aG docker $USER
+# Log out and back in
+```
+
+**Docker: .env not found:**
+```bash
+# .env must be in the same directory as docker-compose.yml
+cp .env.example .env && nano .env
+```
+
+---
+
+## Logs
+
+```bash
+# Docker
+docker compose logs -f kx-bridge
+
+# Binary / Python
+tail -f /tmp/bridge.log   # when using bridge.sh
+```
+
+---
+
+## Security notes
+
+- The bridge binds to `0.0.0.0:7125` by default — use on your local network only
+- `.env` contains printer credentials — do not share publicly
+- The credentials are printer-specific and have no access to Anycubic cloud services
+
+---
+
+## License & legal
+
+This project was created through interoperability research under §69e UrhG (German copyright law).  
+For private, non-commercial use only.

README.md

@@ -2,7 +2,9 @@
 
 Verbindet den Anycubic Kobra X mit OrcaSlicer – ohne Klipper, ohne Raspberry Pi.
 
-KX-Bridge läuft auf deinem PC oder NAS und stellt eine Schnittstelle bereit, über die OrcaSlicer den Drucker direkt steuern kann: Druckstart, Temperatur, Fortschritt, AMS-Farbwechsel.
+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
 
 ---
 
@@ -11,6 +13,7 @@ KX-Bridge läuft auf deinem PC oder NAS und stellt eine Schnittstelle bereit, ü
 | 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 |
@@ -20,6 +23,21 @@ KX-Bridge läuft auf deinem PC oder NAS und stellt eine Schnittstelle bereit, ü
 
 ---
 
+## Was wird unterstützt?
+
+- Druckerstatus (Temperatur, Fortschritt, Zustand)
+- Dateiübertragung und Druckstart
+- Drucksteuerung: Pause, Fortsetzen, Abbrechen
+- Temperaturregelung während des laufenden Drucks
+- Druckgeschwindigkeit (Leise / Normal / Sport)
+- AMS-Farbwechsel (Einziehen / Ausziehen)
+- Licht- und Lüftersteuerung
+- Web-UI mit Dashboard, Temperaturkarten, Achsensteuerung und Kameraansicht
+- Einstellungen und Self-Update direkt im Browser (⚙-Menü)
+- OrcaSlicer-Verbindung (Moonraker-Protokoll)
+
+---
+
 ## Voraussetzungen
 
 - Anycubic Kobra X im LAN-Modus (Drucker muss über LAN erreichbar sein, nicht nur über Anycubic-Cloud)
@@ -35,18 +53,16 @@ KX-Bridge läuft auf deinem PC oder NAS und stellt eine Schnittstelle bereit, ü
 
 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.
+> **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.
 
-Die Zugangsdaten werden mit `extract_credentials` aus dem laufenden AnycubicSlicerNext ausgelesen.
+AnycubicSlicerNext starten und mit dem Drucker verbinden (bis der Drucker-Status angezeigt wird), dann:
 
-Vorbereitung: AnycubicSlicerNext starten und mit dem Drucker verbinden (bis der Drucker-Status angezeigt wird).
-
-Windows:
+**Windows:**
 ```
 extract_credentials.exe --write-env
 ```
 
-Linux:
+**Linux:**
 ```bash
 chmod +x extract_credentials
 ./extract_credentials --write-env
@@ -69,13 +85,13 @@ cp .env.example .env
 
 ### Schritt 3: Bridge starten
 
-Option A – Docker (empfohlen):
+**Option A – Docker (empfohlen):**
 ```bash
 docker compose up -d
 ```
 Läuft im Hintergrund, startet automatisch nach Systemneustart.
 
-Option B – Linux Binary:
+**Option B – Linux Binary:**
 ```bash
 chmod +x kx-bridge
 ./kx-bridge
@@ -83,7 +99,7 @@ chmod +x kx-bridge
 ./bridge.sh start
 ```
 
-Option C – Python direkt:
+**Option C – Python direkt:**
 ```bash
 pip install aiohttp
 python kobrax_moonraker_bridge.py
@@ -102,9 +118,30 @@ python kobrax_moonraker_bridge.py
 ### Schritt 5: OrcaSlicer verbinden
 
 1. Drucker-Einstellungen öffnen
-2. Verbindungstyp: Moonraker
+2. Verbindungstyp: **Moonraker**
 3. Adresse: `http://IP-DES-BRIDGE-PC:7125` eintragen
-4. Auf "Test" klicken – bei erfolgreicher Verbindung erscheint eine Bestätigungsmeldung
+4. Auf „Test" klicken – bei erfolgreicher Verbindung erscheint eine Bestätigungsmeldung
+
+---
+
+## Web-UI
+
+Die Bridge stellt unter `http://BRIDGE-IP:7125` eine Web-Oberfläche bereit:
+
+| Bereich | Funktion |
+|---------|----------|
+| Dashboard | Druckerstatus, Fortschritt, Temperaturübersicht |
+| Temperaturen | Nozzle und Bett direkt setzen |
+| Achsen | X/Y/Z-Bewegung, Motorfreigabe |
+| Druckgeschwindigkeit | Leise / Normal / Sport |
+| Lüfter / Licht | Lüfterdrehzahl und Drucklicht |
+| AMS | Filament einziehen / ausziehen |
+| Kamera | Live-Vorschau (falls vom 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.
 
 ---
 
@@ -133,23 +170,26 @@ docker compose pull && docker compose up -d  # Update
 
 ## Fehlerbehebung
 
-Port 7125 belegt:
+**Port 7125 belegt:**
 ```bash
 ./bridge.sh stop
 ./bridge.sh start
 ```
 
-Verbindungstest in OrcaSlicer schlägt fehl:
+**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:
+**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
 
-Docker: Permission denied:
+**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.
+
+**Docker: Permission denied:**
 ```bash
 sudo usermod -aG docker $USER
 # Neu einloggen, dann erneut versuchen
@@ -172,7 +212,9 @@ sudo usermod -aG docker $USER
 
 ## Sicherheitshinweise
 
-- Alle Zugangsdaten werden ausschließlich lokal verarbeitet
+- 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
 
 ---
 
@@ -180,6 +222,6 @@ sudo usermod -aG docker $USER
 
 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 Tool funktioniert nur für den Prozess des Druckers, dem du selbst gehörst.
+`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.

VERSION

@@ -1 +1 @@
-0.9.1-beta4
+0.9.1-beta6

kobrax_client.py

@@ -394,14 +394,14 @@ class KobraXClient:
     def stop_camera(self) -> dict | None:
         return self.publish("video", "stopCapture")
 
-    def pause_print(self) -> dict | None:
-        return self.publish("print", "pause")
+    def pause_print(self, taskid: str = "-1") -> dict | None:
+        return self.publish("print", "pause", {"taskid": taskid})
 
-    def resume_print(self) -> dict | None:
-        return self.publish("print", "resume")
+    def resume_print(self, taskid: str = "-1") -> dict | None:
+        return self.publish("print", "resume", {"taskid": taskid})
 
-    def stop_print(self) -> dict | None:
-        return self.publish("print", "stop")
+    def stop_print(self, taskid: str = "-1") -> dict | None:
+        return self.publish("print", "stop", {"taskid": taskid})
 
     # -- G-Code Upload -------------------------------------------------------
 

kobrax_moonraker_bridge.py

@@ -48,6 +48,12 @@ KOBRA_TO_KLIPPER_STATE = {
     "checking":      "printing",
     "updated":       "printing",
     "init":          "printing",
+    "pausing":       "paused",
+    "paused":        "paused",
+    "resuming":      "printing",
+    "resumed":       "printing",
+    "stopping":      "printing",
+    "stoped":        "standby",
     "finished":      "complete",
     "failed":        "error",
     "canceled":      "standby",
@@ -118,6 +124,9 @@ class KobraXBridge:
         self._state["print_state"]    = KOBRA_TO_KLIPPER_STATE.get(kobra_state, "printing")
         if kobra_state:
             self._state["kobra_state"] = kobra_state
+        if kobra_state in ("stoped", "canceled"):
+            self._state["progress"] = 0.0
+            self._state["filename"] = ""
         self._state["filename"]       = d.get("filename", self._state["filename"])
         if "progress" in d:
             self._state["progress"]   = float(d["progress"]) / 100.0
@@ -519,17 +528,20 @@ class KobraXBridge:
 
     async def handle_print_pause(self, request):
         loop = asyncio.get_event_loop()
-        await loop.run_in_executor(None, self.client.pause_print)
+        taskid = self._state.get("taskid", "-1")
+        await loop.run_in_executor(None, lambda: self.client.pause_print(taskid))
         return web.json_response({"result": "ok"})
 
     async def handle_print_resume(self, request):
         loop = asyncio.get_event_loop()
-        await loop.run_in_executor(None, self.client.resume_print)
+        taskid = self._state.get("taskid", "-1")
+        await loop.run_in_executor(None, lambda: self.client.resume_print(taskid))
         return web.json_response({"result": "ok"})
 
     async def handle_print_cancel(self, request):
         loop = asyncio.get_event_loop()
-        await loop.run_in_executor(None, self.client.stop_print)
+        taskid = self._state.get("taskid", "-1")
+        await loop.run_in_executor(None, lambda: self.client.stop_print(taskid))
         return web.json_response({"result": "ok"})
 
     async def handle_octoprint_version(self, request):
@@ -1118,7 +1130,7 @@ function toggleTheme(){
 // ── i18n ──
 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_finished:'Abgeschlossen',kobra_failed:'Fehler',kobra_canceled:'Abgebrochen',kobra_offline:'Offline',
+  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',
   speed_silent:'🐢 Leise',speed_normal:'⚡ Normal',speed_sport:'🚀 Sport',
@@ -1143,7 +1155,7 @@ var LANG_DE={
 };
 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_finished:'Finished',kobra_failed:'Error',kobra_canceled:'Cancelled',kobra_offline:'Offline',
+  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',
   speed_silent:'🐢 Silent',speed_normal:'⚡ Normal',speed_sport:'🚀 Sport',