KX-Bridge – Dev Branch

Achtung: Dies ist der Entwicklungs-Branch. Builds hier sind experimentell und nicht für den produktiven Einsatz geeignet. Für stabile Releases → KX-Bridge-Release

Versionsschema

Dev-Builds verwenden das Format:

<basis-version>-dev+<git-hash>

Beispiel: 0.9.1-dev+04a6a20

0.9.1 – Basis der aktuellen stabilen Version
-dev – kennzeichnet den Entwicklungs-Branch
+04a6a20 – 7-stelliger Git-Commit-Hash, eindeutig je Build

Dev-Binaries testen

Dev-Releases sind auf Gitea als Pre-Releases verfügbar: Dev-Releases

Docker (empfohlen)

git clone <repo-url> -b dev
cd kobrax
docker compose up -d

Linux-Binary

# Dev-Release herunterladen (kx-bridge-linux.zip)
unzip kx-bridge-linux.zip
chmod +x kx-bridge
./kx-bridge

config/config.ini und data/ (SQLite + GCode-Store) werden neben dem Binary angelegt. Beim Erststart ohne Drucker zeigt die UI auf http://localhost:7125 den Drucker-Tab mit "+ Drucker hinzufügen" — dort nur die IP eingeben, der Rest wird automatisch importiert.

Windows-EXE

# Dev-Release herunterladen (kx-bridge-windows.zip)
# kx-bridge.exe starten — config/ und data/ liegen daneben

Update-Kanal

Dev-Versionen prüfen automatisch auf neue Dev-Releases — nicht auf stabile Releases. Im Settings-Modal → „Auf Updates prüfen" zeigt den neuesten Dev-Build an.

Aktive Entwicklung (Stand 2026-05-10)

Stand dev-Branch über v0.9.7 hinaus:

Feature	Status
MMU-Emulation (`/printer/objects/query?mmu`) für OrcaSlicer Filament-Sync	✅
GCode Store (SQLite + Thumbnails)	✅
Browser-Tab mit Suche/Filter/Sortierung	✅
Filament-Dialog: Per-Kanal-Remapping (GCode-Kanal → AMS-Slot)	✅
MQTT Print-Payload `ams_settings.ams_box_mapping` (nested)	✅
Print-History in SQLite	✅
Multi-Printer Support (Drucker-Tab + Header-Dropdown)	✅
Multi-Printer in einer Bridge-Instanz (ein Prozess, N Listener)	✅
Drucker-Emulator (`_archive/tools/kx_printer_emulator.py`)	✅
i18n DE/EN für alle neuen UI-Elemente	✅

Multi-Printer-Setup

Eine Bridge-Instanz kann jetzt mehrere Drucker gleichzeitig verwalten — ein Prozess, N MQTT-Verbindungen, N HTTP-Listener, geteilte SQLite + GCode-Verzeichnis.

Konfiguration

In config/config.ini pro Drucker eine [printer_N]-Sektion anlegen:

[printer_1]
name       = Kobra X
printer_ip = <DRUCKER_IP_1>
mqtt_port  = 9883
username   = <MQTT_USER>
password   = <MQTT_PASSWORT>
mode_id    = 20030
device_id  = <DEVICE_ID_1>
http_port  = 7125

[printer_2]
name       = Drucker 2
printer_ip = <DRUCKER_IP_2>
mqtt_port  = 9883
username   = <MQTT_USER>
password   = <MQTT_PASSWORT>
mode_id    = 20030
device_id  = <DEVICE_ID_2>
http_port  = 7126

Credentials per extract_credentials oder fetch_credentials ermitteln (siehe Haupt-README).

http_port ist optional — Default ist 7125 + (N-1). Wenn keine [printer_N]-Sektionen existieren, läuft die Bridge im klassischen Einzel-Modus mit [connection] und einem Listener.

Docker

docker-compose.yml exposed jetzt einen Port-Range 7125-7130:

ports:
  - "7125-7130:7125-7130"

docker compose up -d
# Drucker 1: http://localhost:7125
# Drucker 2: http://localhost:7126

OrcaSlicer / Mainsail richten den Klipper-Endpunkt pro Drucker auf den jeweiligen Port — keine Slicer-Anpassungen nötig.

Stabile Version

Für den produktiven Einsatz bitte die stabile Version verwenden: → Zum stabilen Release

3.8 KiB Raw Blame History Unescape Escape