From 2aaaa5bbbe906c065881a41bec9920a80c6cc34c Mon Sep 17 00:00:00 2001 From: viewit Date: Tue, 12 May 2026 17:20:38 +0200 Subject: [PATCH] README.de.md aktualisiert --- README.de.md | 260 +++++++++++++++++++++++++++------------------------ 1 file changed, 140 insertions(+), 120 deletions(-) diff --git a/README.de.md b/README.de.md index a6fc6e6..ac5d6d3 100644 --- a/README.de.md +++ b/README.de.md @@ -1,160 +1,180 @@ -

KX-Bridge Logo

+
-# KX-Bridge – Anycubic Kobra X +KX-Bridge -**Version:** 0.9.8 +# KX-Bridge -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. +**Steuere deinen Anycubic Kobra X mit OrcaSlicer — ohne Klipper, ohne Raspberry Pi.** + +Eine Moonraker-kompatible Bridge, die direkt mit dem Drucker spricht. + +
+ +[![Ko-fi](https://img.shields.io/badge/Ko--fi-Support%20this%20project-FF5E5B?style=for-the-badge&logo=ko-fi&logoColor=white)](https://ko-fi.com/viewitde) +  +[![Releases](https://img.shields.io/badge/Download-Releases-2EA043?style=for-the-badge&logo=gitea&logoColor=white)](https://gitea.it-drui.de/viewit/KX-Bridge-Release/releases) +  +[![Video](https://img.shields.io/badge/YouTube-Tutorial-FF0000?style=for-the-badge&logo=youtube&logoColor=white)](https://www.youtube.com/watch?v=1Ql4wfH27fM) + +Gefällt dir KX-Bridge? Ein Kaffee auf Ko-fi hält das Projekt am Leben. ☕ + +
--- -## Schnellstart in 3 Schritten +## ✨ Was kann KX-Bridge? -### Schritt 1 – Drucker vorbereiten +| | 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 | -Den Kobra X in den LAN-Modus versetzen: -**Drucker-Display → Einstellungen → LAN-Modus einschalten** +--- -### Schritt 2 – Credentials holen +## 🚀 Schnellstart -Die MQTT-Zugangsdaten sind druckerspezifisch und an die Hardware gebunden. +### 1. Drucker vorbereiten -**Option A – fetch_credentials (empfohlen):** +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 + +[![KX-Bridge Setup & Usage](https://img.youtube.com/vi/1Ql4wfH27fM/hqdefault.jpg)](https://www.youtube.com/watch?v=1Ql4wfH27fM) + +--- + +## 🔧 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. -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. +Alternativ (wenn die IP unbekannt ist): AnycubicSlicerNext öffnen, Drucker verbinden, +dann `extract_credentials` ausführen → gibt Username, Passwort, Device-ID und IP aus. -**Option B – extract_credentials (wenn Drucker-IP unbekannt):** +> **Downloads:** [Releases](https://gitea.it-drui.de/viewit/KX-Bridge-Release/releases) → `fetch_credentials` / `extract_credentials` (Linux & Windows) -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 +## ⚙️ Nützliche Befehle ```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 - -[![KX-Bridge Setup & Bedienung](https://img.youtube.com/vi/1Ql4wfH27fM/hqdefault.jpg)](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 +docker compose logs -f # Logs anzeigen +docker compose down # Bridge stoppen +docker compose up -d --build # Bridge neu bauen & starten (nach Update) ``` --- -## Fehlerbehebung +## 🩹 Troubleshooting -**„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`) +
+"Falsche MQTT-Zugangsdaten" beim Start -**Drucker nicht gefunden / kein LAN-Modus:** -- Am Drucker-Display: Einstellungen → LAN-Modus einschalten +- Drucker über *„+ Drucker hinzufügen"* erneut hinzufügen, oder + `fetch_credentials --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`) +
+ +
+Drucker nicht gefunden / kein LAN-Modus + +- Am Drucker-Display: Einstellungen → LAN-Modus aktivieren - Drucker und Bridge müssen im selben Netzwerk sein +
+ +
+Docker: Permission denied -**Docker: Permission denied:** ```bash -sudo usermod -aG docker $USER # dann neu einloggen +sudo usermod -aG docker $USER # danach aus- und wieder einloggen ``` +
+ +
+Upgrade von 0.9.1 oder älter + +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. +
--- -## Sicherheitshinweise +## 🔒 Sicherheit -- 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 +- Die Bridge ist im lokalen Netzwerk unter `http://: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 & Rechtliches +## 📄 Lizenz -Interoperabilitätsforschung gem. §69e UrhG — ausschließlich private, nicht-kommerzielle Nutzung. +Interoperabilitätsforschung gem. §69e UrhG — private, nicht-kommerzielle Nutzung. -

- - Ko-fi Support - -

+
+
+ +**Wenn dir KX-Bridge hilft, freut sich das Projekt über Unterstützung:** + +[![Ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/viewitde) + +
\ No newline at end of file