# KX-Bridge – Anycubic Kobra X **Version:** 0.9.7 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 und an die Hardware gebunden. **Option A – fetch_credentials (empfohlen):** ```bash fetch_credentials --ip 192.168.x.x --write-config ``` Holt die Credentials direkt per HTTP vom Drucker und schreibt sie automatisch in `config/config.ini`. Benötigt nur die Drucker-IP — kein Slicer nötig. **Option B – extract_credentials (wenn Drucker-IP unbekannt):** 1. **AnycubicSlicerNext** öffnen und Drucker verbinden (bis Status angezeigt wird) 2. **`extract_credentials`** ausführen — gibt Username, Password, Device-ID und Drucker-IP aus 3. Werte im Web-UI eintragen (⚙-Menü) > **Download:** [gitea.it-drui.de/viewit/KX-Bridge-Release/releases](https://gitea.it-drui.de/viewit/KX-Bridge-Release/releases) → `fetch_credentials` / `extract_credentials` (Linux & Windows) im jeweiligen Release-Asset ### Schritt 3 – Bridge starten ```bash ./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 → Bei Option B: 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. --- ## 📺 Video Tutorial [](https://www.youtube.com/watch?v=1Ql4wfH27fM) --- ## ⚠️ 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): ```bash chmod +x kx-bridge ./kx-bridge ``` **Python direkt:** ```bash 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 ```bash # Logs anzeigen docker-compose logs -f # Bridge stoppen docker-compose down # Bridge neu starten (nach Update) ./start.sh ``` --- ## Fehlerbehebung **„Falsche MQTT-Zugangsdaten"** beim Start: - `fetch_credentials --ip --write-config` erneut ausführen und Bridge neu starten - Wenn IP unbekannt: 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:** ```bash sudo usermod -aG docker $USER # dann neu einloggen ``` --- ## Sicherheitshinweise - Die Bridge ist im lokalen Netzwerk erreichbar unter `http://: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.