# KX-Bridge – Anycubic Kobra X **Version:** 0.9.6.1 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](https://gitea.it-drui.de/viewit/KX-Bridge-Release/releases) → `extract_credentials.exe` (Windows) / `extract_credentials` (Linux) 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 → 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): ```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: - 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.