viewit
fd4b9b1254
Bridge wird jetzt automatisch als Multi-Arch-Image (amd64+arm64) nach gitea.it-drui.de/viewit/kx-bridge gebaut. Nutzer können mit 'docker compose pull && docker compose up -d' updaten.
226 lines
7.9 KiB
Markdown
226 lines
7.9 KiB
Markdown
<div align="center">
|
||
|
||
<img src="knlogo.png" alt="KX-Bridge" width="160"/>
|
||
|
||
# KX-Bridge
|
||
|
||
**Steuere deinen Anycubic Kobra X mit OrcaSlicer — ohne Klipper, ohne Raspberry Pi.**
|
||
|
||
Eine Moonraker-kompatible Bridge, die direkt mit dem Drucker spricht.
|
||
|
||
<sub>🇬🇧 <a href="README.md">English version</a></sub>
|
||
|
||
<br>
|
||
|
||
[](https://ko-fi.com/viewitde)
|
||
|
||
[](https://gitea.it-drui.de/viewit/KX-Bridge-Release/releases)
|
||
|
||
[](https://gitea.it-drui.de/viewit/KX-Bridge-Release/releases)
|
||
|
||
[](https://www.youtube.com/watch?v=1Ql4wfH27fM)
|
||
|
||
<sub>Gefällt dir KX-Bridge? Ein Kaffee auf <a href="https://ko-fi.com/viewitde">Ko-fi</a> hält das Projekt am Leben. ☕</sub>
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
## ✨ Was kann KX-Bridge?
|
||
|
||
| | Feature |
|
||
|---|---|
|
||
| 🖨️ | **Druckersteuerung** — Start, Pause, Resume, Abbruch, Temperaturen, Druckgeschwindigkeit |
|
||
| 📊 | **Live-Status** — Temperatur, Fortschritt, Layer, Restzeit, Kamera-Stream |
|
||
| 🎨 | **AMS / Multicolor** — Filament-Slots, Per-Kanal-Remapping, MMU-Emulation für OrcaSlicer Filament-Sync |
|
||
| 🗂️ | **GCode-Browser** — hochgeladene Dateien mit Thumbnail, Druckhistorie, Suche & Filter |
|
||
| 🧩 | **Multi-Printer** — mehrere Drucker in **einer** Bridge-Instanz, Umschalten per Dropdown |
|
||
| ➕ | **Drucker hinzufügen per Klick** — nur die IP eingeben, Zugangsdaten werden automatisch importiert |
|
||
| 🔄 | **Self-Update** — neue Versionen direkt im Browser installieren |
|
||
| 🌐 | **OrcaSlicer** — volles Moonraker-Protokoll (HTTP + WebSocket), DE/EN UI |
|
||
|
||
---
|
||
|
||
## 🚀 Schnellstart
|
||
|
||
### 1. Drucker vorbereiten
|
||
|
||
LAN-Modus am Kobra X aktivieren:
|
||
**Drucker-Display → Einstellungen → LAN-Modus aktivieren**
|
||
|
||
### 2. Bridge starten
|
||
|
||
**Docker (empfohlen):**
|
||
```bash
|
||
docker compose up -d
|
||
```
|
||
|
||
**Linux-Binary (kein Docker):**
|
||
```bash
|
||
chmod +x kx-bridge && ./kx-bridge
|
||
```
|
||
|
||
**Windows-EXE (kein Docker):**
|
||
```
|
||
kx-bridge.exe
|
||
```
|
||
> `config\` und `data\` werden neben der EXE angelegt — portabel.
|
||
|
||
> Bei Linux- und Windows-Binary liegen `config/` und `data/` (Einstellungen, SQLite,
|
||
> GCode-Store) jeweils neben dem Programm. Einfach den ganzen Ordner kopieren = umziehen.
|
||
|
||
**Python direkt:**
|
||
```bash
|
||
pip install -r bridge/requirements.txt
|
||
python bridge/kobrax_moonraker_bridge.py
|
||
```
|
||
|
||
### 3. Drucker einrichten
|
||
|
||
Web-UI öffnen: **`http://BRIDGE-IP:7125`**
|
||
|
||
Beim Erststart erscheint der **Drucker-Tab** mit *„+ Drucker hinzufügen"* — einfach die
|
||
IP-Adresse des Druckers eingeben, der Rest (Username, Passwort, Device-ID) wird automatisch
|
||
vom Drucker geholt und entschlüsselt. Fertig.
|
||
|
||
> Mehrere Drucker? Einfach mehrfach *„+ Drucker hinzufügen"* — jeder bekommt seinen eigenen
|
||
> Port (7125, 7126, …) und ist im Header-Dropdown auswählbar.
|
||
|
||
### 4. OrcaSlicer verbinden
|
||
|
||
Drucker → Verbindungstyp **Moonraker** → Host: `http://BRIDGE-IP:7125`
|
||
|
||
> ⚠️ Verbindungstyp muss **Moonraker** sein (nicht „Bambu" oder „Klipper").
|
||
> Vollständige URL inkl. `http://` und Port `:7125` im Host-Feld eintragen.
|
||
|
||
---
|
||
|
||
## 📺 Video-Tutorial
|
||
|
||
[](https://www.youtube.com/watch?v=1Ql4wfH27fM)
|
||
|
||
---
|
||
|
||
## 🎨 Empfohlener Slicer
|
||
|
||
Für die beste Erfahrung mit der KX-Bridge bieten wir einen **gepatchten
|
||
OrcaSlicer-Build**, der drei offene SoftFever/OrcaSlicer-PRs bündelt: das
|
||
Anycubic-Kobra-X-Druckerprofil, einen Multicolor-G-Code-Fix und — am wichtigsten
|
||
— einen Moonraker/Happy-Hare-Filament-Sync-Fix, der die AMS-Slot-Positionen auch
|
||
bei einem leeren Slot in der Mitte korrekt beibehält.
|
||
|
||
→ **[OrcaSlicer-KX Releases](https://gitea.it-drui.de/viewit/OrcaSlicer-KX/releases/latest)** (Linux AppImage + Windows ZIP)
|
||
|
||
Standard-OrcaSlicer funktioniert auch; der gepatchte Build verbessert
|
||
hauptsächlich das AMS-Handling. Es ist ein Build von
|
||
[OrcaSlicer](https://github.com/SoftFever/OrcaSlicer) (AGPL-3.0); der Quellcode
|
||
ist über die verlinkten PRs verfügbar.
|
||
|
||
---
|
||
|
||
## 🏠 Community & Integrationen
|
||
|
||
- **[Home-Assistant-Integration](https://github.com/gangoke/kobrax-lan-hass-component)**
|
||
von [@gangoke](https://github.com/gangoke) — bindet Sensoren, Drucksteuerung,
|
||
Licht, Kamera und das GCode-Vorschaubild als native Home-Assistant-Entitäten ein.
|
||
|
||
> Dies sind **Community-Projekte**, die nicht von KX-Bridge betreut oder
|
||
> supportet werden. Bei Fragen oder Problemen bitte das verlinkte Repository nutzen.
|
||
|
||
---
|
||
|
||
## 🔧 Zugangsdaten manuell ermitteln
|
||
|
||
Normalerweise nicht nötig — *„+ Drucker hinzufügen"* macht das automatisch. Falls doch:
|
||
|
||
```bash
|
||
fetch_credentials --ip 192.168.x.x --write-config
|
||
```
|
||
Holt die Zugangsdaten per HTTP direkt vom Drucker und schreibt sie in `config/config.ini`.
|
||
Nur die Drucker-IP nötig, kein Slicer.
|
||
|
||
Alternativ (wenn die IP unbekannt ist): AnycubicSlicerNext öffnen, Drucker verbinden,
|
||
dann `extract_credentials` ausführen → gibt Username, Passwort, Device-ID und IP aus.
|
||
|
||
> **Downloads:** [Releases](https://gitea.it-drui.de/viewit/KX-Bridge-Release/releases) → `fetch_credentials` / `extract_credentials` (Linux & Windows)
|
||
|
||
---
|
||
|
||
## ⚙️ Nützliche Befehle
|
||
|
||
```bash
|
||
docker compose logs -f # Logs anzeigen
|
||
docker compose down # Bridge stoppen
|
||
docker compose pull && docker compose up -d # auf neueste veröffentlichte Version updaten
|
||
docker compose up -d --build # lokal selber bauen (statt zu pullen)
|
||
```
|
||
|
||
---
|
||
|
||
## 🩹 Troubleshooting
|
||
|
||
<details>
|
||
<summary><b>"Falsche MQTT-Zugangsdaten" beim Start</b></summary>
|
||
|
||
- Drucker über *„+ Drucker hinzufügen"* erneut hinzufügen, oder
|
||
`fetch_credentials --ip <ip> --write-config` ausführen und Bridge neu starten
|
||
- Nur die IP-Adresse eingeben, ohne Port (✗ `192.168.1.102:9883` → ✓ `192.168.1.102`)
|
||
</details>
|
||
|
||
<details>
|
||
<summary><b>Drucker nicht gefunden / kein LAN-Modus</b></summary>
|
||
|
||
- Am Drucker-Display: Einstellungen → LAN-Modus aktivieren
|
||
- Drucker und Bridge müssen im selben Netzwerk sein
|
||
</details>
|
||
|
||
<details>
|
||
<summary><b>Docker: Permission denied</b></summary>
|
||
|
||
```bash
|
||
sudo usermod -aG docker $USER # danach aus- und wieder einloggen
|
||
```
|
||
</details>
|
||
|
||
<details>
|
||
<summary><b>Upgrade von 0.9.1 oder älter</b></summary>
|
||
|
||
Ab 0.9.2 speichert KX-Bridge die Einstellungen in `config/config.ini` statt `.env`.
|
||
Die Migration läuft automatisch beim ersten Start nach dem Upgrade — keine Aktion nötig.
|
||
</details>
|
||
|
||
---
|
||
|
||
## 🔒 Sicherheit
|
||
|
||
- Die Bridge ist im lokalen Netzwerk unter `http://<host-IP>:7125` erreichbar — **nicht** ins Internet exposen
|
||
- `config/config.ini` enthält Drucker-Zugangsdaten — nicht öffentlich teilen
|
||
- Die Zugangsdaten geben **keinen** Zugriff auf Anycubic-Cloud-Dienste
|
||
|
||
---
|
||
|
||
## 📄 Lizenz
|
||
|
||
[](LICENSE)
|
||
|
||
KX-Bridge steht unter der **GNU General Public License v3.0** ([LICENSE](LICENSE)).
|
||
Forks und Erweiterungen müssen bei Weitergabe ebenfalls unter GPLv3 stehen.
|
||
|
||
Die MQTT-Protokoll-Implementierung ist das Ergebnis unabhängiger
|
||
Reverse-Engineering-Arbeit zur Herstellung der Interoperabilität (§69e UrhG /
|
||
EU-Softwarerichtlinie Art. 6). Drittmaterial im Repository (Anycubic-
|
||
TLS-Zertifikate) fällt **nicht** unter die GPLv3 und ist ausschließlich
|
||
enthalten, um die Authentifizierung am eigenen Drucker zu ermöglichen.
|
||
Details + Disclaimer in [NOTICE.md](NOTICE.md).
|
||
|
||
Dieses Projekt ist unabhängig und steht in keinem Zusammenhang mit Anycubic.
|
||
|
||
<div align="center">
|
||
<br>
|
||
|
||
**Wenn dir KX-Bridge hilft, freut sich das Projekt über Unterstützung:**
|
||
|
||
[](https://ko-fi.com/viewitde)
|
||
|
||
</div>
|