KX-Bridge

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.

---

Enthaltene Dateien

Datei	Beschreibung
kobrax_moonraker_bridge.py	Bridge-Hauptprogramm
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

---

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

---

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.

Die Zugangsdaten werden mit extract_credentials aus dem laufenden AnycubicSlicerNext ausgelesen.

Vorbereitung: AnycubicSlicerNext starten und mit dem Drucker verbinden (bis der Drucker-Status angezeigt wird).

Windows:

extract_credentials.exe --write-env

Linux:

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

cp .env.example .env
# .env öffnen und Werte kontrollieren

---

Schritt 3: Bridge starten

Option A – Docker (empfohlen):

docker compose up -d

Läuft im Hintergrund, startet automatisch nach Systemneustart.

Option B – Linux Binary:

chmod +x kx-bridge
./kx-bridge
# Oder mit Service-Manager:
./bridge.sh start

Option C – Python direkt:

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

---

Schritt 5: OrcaSlicer verbinden

1. Drucker-Einstellungen öffnen
2. Verbindungstyp: Moonraker
3. Adresse: http://IP-DES-BRIDGE-PC:7125 eintragen
4. Auf "Test" klicken – bei erfolgreicher Verbindung erscheint eine Bestätigungsmeldung

---

bridge.sh – Service-Manager (Linux)

./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

---

Docker – Nützliche Befehle

docker compose up -d                         # Starten
docker compose down                          # Stoppen
docker compose logs -f                       # Logs verfolgen
docker compose pull && docker compose up -d  # Update

---

Fehlerbehebung

Port 7125 belegt:

./bridge.sh stop
./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

Docker: Permission denied:

sudo usermod -aG docker $USER
# Neu einloggen, dann erneut versuchen

---

Konfigurationsreferenz (.env)

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

---

Sicherheitshinweise

• Alle Zugangsdaten werden ausschließlich lokal verarbeitet

---

Hinweis zur Nutzung

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.

Das Projekt steht in keiner Verbindung zu Anycubic und wird nicht kommerziell betrieben.