KX-Bridge-Release/README.de.md

KX-Bridge – Anycubic Kobra X

Version: 0.9.4

Steuere deinen Anycubic Kobra X mit OrcaSlicer — ohne Klipper, ohne Raspberry Pi.
KX-Bridge ist eine Moonraker-kompatible Bridge die direkt mit dem Drucker kommuniziert.

---

Schnellstart in 3 Schritten

Schritt 1 – Drucker vorbereiten

Den Kobra X in den LAN-Modus versetzen:
Drucker-Display → Einstellungen → LAN-Modus einschalten

Schritt 2 – Credentials holen

Die MQTT-Zugangsdaten sind druckerspezifisch. So holst du sie:

1. AnycubicSlicerNext öffnen und Drucker verbinden (bis Status angezeigt wird)
2. extract_credentials.exe (Windows) oder extract_credentials (Linux) ausführen — gibt Username, Password, Device-ID und Drucker-IP aus
3. Werte merken / kopieren

Download: gitea.it-drui.de/viewit/KX-Bridge-Release/releases → extract_credentials.exe (Windows) / extract_credentials (Linux) im jeweiligen Release-Asset

Schritt 3 – Bridge starten

./start.sh

Das Skript baut das Docker-Image automatisch beim ersten Aufruf.

Web-UI öffnen: http://BRIDGE-IP:7125
→ Das ⚙-Menü öffnet sich beim ersten Start automatisch
→ Credentials aus Schritt 2 eintragen → Speichern & Neustart

OrcaSlicer verbinden:
Drucker → Verbindungstyp Moonraker → Host: http://BRIDGE-IP:7125

Wichtig: Verbindungstyp muss Moonraker sein (nicht „Bambu" oder „Klipper").
Im Host-Feld vollständige URL mit http:// und Port :7125 angeben.

---

⚠️ Update von 0.9.1 oder älter

Ab 0.9.2 speichert KX-Bridge Einstellungen in config/config.ini statt in .env.

Migration erfolgt automatisch — keine manuelle Aktion nötig:

• Beim ersten Start nach dem Update liest die Bridge die vorhandene .env und erstellt config/config.ini automatisch
• Einstellungen bleiben ab sofort nach docker-compose restart und zukünftigen Updates erhalten
• Die .env-Datei bleibt read-only gemountet als Migrationsquelle — kann liegen bleiben
• Zum manuellen Anlegen einer config.ini: Vorlage unter config/config.ini.example kopieren

---

Was wird unterstützt?

Funktion	Details
Druckerstatus	Temperatur, Fortschritt, Zustand, Restzeit
Drucksteuerung	Start, Pause, Fortsetzen, Abbrechen
Temperaturregelung	Nozzle und Bett während des Drucks
Druckgeschwindigkeit	Leise / Normal / Sport
AMS-Farbwechsel	Filament einziehen / ausziehen
Licht & Lüfter	Drucklicht und Lüfterdrehzahl
Web-UI	Dashboard, Achsensteuerung, Kameraansicht
Self-Update	Neue Versionen direkt im Browser installieren
OrcaSlicer	Moonraker-Protokoll (HTTP + WebSocket)

---

Alternativen zu Docker

Linux Binary (kein Docker nötig):

chmod +x kx-bridge
./kx-bridge

Python direkt:

pip install aiohttp
python bridge/kobrax_moonraker_bridge.py

Web-UI jeweils unter http://localhost:7125 — ⚙-Menü führt durch die Erstkonfiguration.

---

Nützliche Befehle

# Logs anzeigen
docker-compose logs -f

# Bridge stoppen
docker-compose down

# Bridge neu starten (nach Update)
./start.sh

---

Fehlerbehebung

„Falsche MQTT-Zugangsdaten" beim Start:

• AnycubicSlicerNext neu starten, Drucker verbinden, extract_credentials erneut ausführen
• Nur die IP-Adresse ins Feld eintragen, keinen Port (✗ 192.168.1.102:9883 → ✓ 192.168.1.102)

Drucker nicht gefunden / kein LAN-Modus:

• Am Drucker-Display: Einstellungen → LAN-Modus einschalten
• Drucker und Bridge müssen im selben Netzwerk sein

Docker: Permission denied:

sudo usermod -aG docker $USER  # dann neu einloggen

---

Sicherheitshinweise

• Die Bridge ist im lokalen Netzwerk erreichbar unter http://<Host-IP>:7125 — nicht ins Internet freigeben
• config/config.ini enthält Drucker-Credentials — nicht öffentlich teilen
• Credentials haben keinen Zugang zu Anycubic-Cloud-Diensten

---

Lizenz & Rechtliches

Interoperabilitätsforschung gem. §69e UrhG — ausschließlich private, nicht-kommerzielle Nutzung.