build: sources for v0.9.21

Named-Volume-Compose ohne ENV-Pflichtfelder — Bridge startet im
Offline-Modus, User trägt Drucker-IP in der UI ein.

CHANGELOG.de.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [0.9.21] – 2026-06-14
+
+### Behoben
+- **Kamera-Stream auf Android (Chrome / Firefox) nicht sichtbar.** Android-Browser
+  unterstützen `multipart/x-mixed-replace` (MJPEG) nicht. Die UI erkennt Android
+  jetzt automatisch und fällt auf Snapshot-Polling mit 5 fps zurück
+  (`/api/camera/snapshot` alle 200 ms) — keine Server-Änderung nötig.
+
+### Geändert
+- Docker-Image auf **Debian 12 (Bookworm)** gepinnt (`python:3.11-slim-bookworm`),
+  um Kompatibilitätsprobleme mit glibc 2.41 zu vermeiden, die das aktuell von
+  `python:3.11-slim` gezogene Debian 13 Basis-Image mitbringt.
+- MQTT- und HTTP-Verbindungen erzwingen jetzt **IPv4** (`AF_INET`), um
+  Verbindungsfehler auf Hosts zu verhindern, bei denen der Drucker nur über IPv4
+  erreichbar ist, das OS aber IPv6 bevorzugt.
+- Extruder-Stub in der Moonraker-`configfile`-Antwort enthält jetzt `sensor_type`
+  und `filament_diameter` — behebt einen Mobileraker-Absturz
+  (`Null is not a subtype of Object`, Issue #48).
+
 ## [0.9.20] – 2026-06-08
 
 ### Neu

CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [0.9.21] – 2026-06-14
+
+### Fixed
+- **Camera stream not visible on Android (Chrome / Firefox).** Android
+  browsers do not support `multipart/x-mixed-replace` (MJPEG). The UI
+  now detects Android and falls back to snapshot-polling at 5 fps
+  (`/api/camera/snapshot` every 200 ms) — no server-side change needed.
+
+### Changed
+- Docker image now pinned to **Debian 12 (Bookworm)** (`python:3.11-slim-bookworm`)
+  to avoid glibc 2.41 compatibility issues introduced by the Debian 13
+  base image that `python:3.11-slim` recently started pulling.
+- MQTT and HTTP connections now **force IPv4** (`AF_INET`) to prevent
+  connection failures on hosts where the printer is only reachable via
+  IPv4 but the OS prefers IPv6.
+- Extruder stub in the Moonraker `configfile` response now includes
+  `sensor_type` and `filament_diameter` — fixes a Mobileraker crash
+  (`Null is not a subtype of Object`, issue #48).
+
 ## [0.9.20] – 2026-06-08
 
 ### New

Dockerfile

@@ -1,4 +1,4 @@
-FROM python:3.11-slim
+FROM python:3.11-slim-bookworm
 
 WORKDIR /app
 

VERSION

@@ -1 +1 @@
-0.9.20
+0.9.21

docker-compose.portainer.yml

@@ -0,0 +1,29 @@
+# KX-Bridge — Portainer Stack
+#
+# Paste this into Portainer → Stacks → Add stack → Web editor
+#
+# No configuration needed upfront — just deploy, open http://HOST-IP:7125
+# and add your printer via the UI (IP only, credentials are fetched automatically).
+#
+# All data (config, GCode store, database) is stored in named Docker volumes
+# managed by Portainer.
+
+services:
+  kx-bridge:
+    image: gitea.it-drui.de/viewit/kx-bridge:latest
+    volumes:
+      - kx-bridge-config:/app/config
+      - kx-bridge-data:/app/data
+    ports:
+      # Port 7125 = first printer. Add 7126, 7127, … for each additional printer.
+      - "7125:7125"
+    restart: unless-stopped
+    logging:
+      driver: json-file
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+volumes:
+  kx-bridge-config:
+  kx-bridge-data:

docs/filament-preset-bridge-guide.md

@@ -0,0 +1,344 @@
+# Eigene Filament-Presets anlegen, prüfen und mit KX-Bridge verknüpfen
+
+> **Gilt für:** OrcaSlicer-KX v2.4.0-alpha-kx2 oder neuer
+
+---
+
+## Was ist die `filament_id` und warum ist sie wichtig?
+
+Jedes Filament-Preset in OrcaSlicer hat eine interne `filament_id`. Diese ID wird von der KX-Bridge genutzt, um beim AMS-Sync das richtige Preset zuzuordnen.
+
+- System-Presets (z.B. "Polymaker PolyTerra PLA") haben eine feste ID wie `GFL99` oder `OGFL04`.
+- **Eigene (User-)Presets** bekommen in OrcaSlicer-KX automatisch eine eindeutige ID, die mit `P` beginnt (z.B. `P3a7f2c1`).
+
+Ohne eindeutige ID zeigt OrcaSlicer beim Sync immer "Generic PLA" — auch wenn das Preset existiert.
+
+---
+
+## 1. Eigenes Filament-Preset anlegen
+
+1. OrcaSlicer-KX starten
+2. Rechts oben im **Filament-Dropdown** ein passendes Basis-Preset wählen (z.B. "Generic PLA" oder ein Hersteller-Preset)
+3. Einstellungen nach Wunsch anpassen (Temperaturen, Kühlung, etc.)
+4. Auf das **Speichern-Symbol** (Diskette) klicken → **"Save as new preset"**
+5. Namen eingeben — z.B. `SUNLU PLA+ 2.0`
+   > Der Name muss später exakt so in der Bridge eingetragen werden.
+6. Drucker auswählen: **Anycubic Kobra X 0.4 nozzle** — wichtig für die Kompatibilität!
+7. **Speichern** klicken
+8. OrcaSlicer **einmal neu starten** — erst dann wird die `filament_id` dauerhaft gespeichert.
+
+---
+
+## 2. Eindeutige ID prüfen
+
+Nach dem Neustart prüfen, ob die ID korrekt gesetzt wurde:
+
+**Windows:**
+```
+%APPDATA%\OrcaSlicer\user\default\filament\SUNLU PLA+ 2.0.json
+```
+
+**Linux:**
+```
+~/.config/OrcaSlicer/user/default/filament/SUNLU PLA+ 2.0.json
+```
+
+Die Datei öffnen und nach `filament_id` suchen:
+
+```json
+{
+  "filament_id": "P3a7f2c1",
+  ...
+}
+```
+
+✅ Korrekt: ID beginnt mit `P` gefolgt von 7 Hex-Zeichen  
+❌ Fehlt oder leer: OrcaSlicer-KX zu alt — Update auf v2.4.0-alpha-kx2 oder neuer
+
+---
+
+## 3. Preset auf einen anderen PC übertragen (Import)
+
+### Exportieren (Quell-PC)
+
+Die Preset-Datei einfach kopieren:
+
+**Windows:**
+```
+%APPDATA%\OrcaSlicer\user\default\filament\SUNLU PLA+ 2.0.json
+```
+
+**Linux:**
+```
+~/.config/OrcaSlicer/user/default/filament/SUNLU PLA+ 2.0.json
+```
+
+### Importieren (Ziel-PC)
+
+**Methode A — Datei direkt kopieren:**
+1. Die `.json`-Datei in das gleiche Verzeichnis auf dem Ziel-PC kopieren
+2. OrcaSlicer neu starten → Preset erscheint im Dropdown
+
+**Methode B — OrcaSlicer Import-Funktion:**
+1. In OrcaSlicer: **File → Import → Import Configs...**
+2. Die `.json`-Datei auswählen
+3. OrcaSlicer neu starten
+
+> **Wichtig:** Die `filament_id` in der Datei bleibt erhalten — das Preset wird auf dem Ziel-PC genauso erkannt wie auf dem Quell-PC.
+
+---
+
+## 4. Preset in KX-Bridge verknüpfen
+
+1. KX-Bridge UI öffnen
+2. **Filament-Verwaltung** → AMS-Slot auswählen
+3. Im Feld **Filament-Name** exakt den OrcaSlicer-Preset-Namen eintragen:
+   ```
+   SUNLU PLA+ 2.0
+   ```
+4. Speichern
+
+Die Bridge sendet beim Sync `filament_name: "SUNLU PLA+ 2.0"` → OrcaSlicer findet das Preset anhand von Name und `filament_id` → zeigt es korrekt an.
+
+---
+
+## Wichtige Hinweise
+
+| Was | Warum |
+|-----|-------|
+| Name in OrcaSlicer und Bridge müssen **exakt** übereinstimmen | Groß-/Kleinschreibung und Sonderzeichen werden verglichen |
+| Preset muss für **Anycubic Kobra X 0.4 nozzle** kompatibel sein | Beim Speichern den richtigen Drucker auswählen |
+| Nach dem ersten Speichern OrcaSlicer **neu starten** | Erst dann wird die `filament_id` persistent geschrieben |
+| **OrcaSlicer-KX v2.4.0-alpha-kx2** oder neuer verwenden | Ältere Versionen generieren keine eindeutige `filament_id` für User-Presets |
+
+---
+---
+
+# How to Create, Verify and Import Custom Filament Presets for KX-Bridge
+
+> **Requires:** OrcaSlicer-KX v2.4.0-alpha-kx2 or newer
+
+---
+
+## What is the `filament_id` and why does it matter?
+
+Every filament preset in OrcaSlicer has an internal `filament_id`. The KX-Bridge uses this ID to match the correct preset during AMS sync.
+
+- System presets (e.g. "Polymaker PolyTerra PLA") have a fixed ID like `GFL99` or `OGFL04`.
+- **Custom (user) presets** automatically receive a unique ID starting with `P` (e.g. `P3a7f2c1`) in OrcaSlicer-KX.
+
+Without a unique ID, OrcaSlicer will always show "Generic PLA" during sync — even if the preset exists.
+
+---
+
+## 1. Create a Custom Filament Preset
+
+1. Launch OrcaSlicer-KX
+2. Select a suitable base preset from the **filament dropdown** (e.g. "Generic PLA" or a vendor preset)
+3. Adjust settings as needed (temperatures, cooling, etc.)
+4. Click the **save icon** (floppy disk) → **"Save as new preset"**
+5. Enter a name — e.g. `SUNLU PLA+ 2.0`
+   > This name must be entered in the bridge exactly as typed here.
+6. Select printer: **Anycubic Kobra X 0.4 nozzle** — required for compatibility!
+7. Click **Save**
+8. **Restart OrcaSlicer once** — the `filament_id` is only written permanently after a restart.
+
+---
+
+## 2. Verify the Unique ID
+
+After restarting, check that the ID was set correctly:
+
+**Windows:**
+```
+%APPDATA%\OrcaSlicer\user\default\filament\SUNLU PLA+ 2.0.json
+```
+
+**Linux:**
+```
+~/.config/OrcaSlicer/user/default/filament/SUNLU PLA+ 2.0.json
+```
+
+Open the file and look for `filament_id`:
+
+```json
+{
+  "filament_id": "P3a7f2c1",
+  ...
+}
+```
+
+✅ Correct: ID starts with `P` followed by 7 hex characters  
+❌ Missing or empty: Your OrcaSlicer-KX version is too old — update to v2.4.0-alpha-kx2 or newer
+
+---
+
+## 3. Transfer a Preset to Another PC (Import)
+
+### Export (source PC)
+
+Simply copy the preset file:
+
+**Windows:**
+```
+%APPDATA%\OrcaSlicer\user\default\filament\SUNLU PLA+ 2.0.json
+```
+
+**Linux:**
+```
+~/.config/OrcaSlicer/user/default/filament/SUNLU PLA+ 2.0.json
+```
+
+### Import (target PC)
+
+**Method A — Copy file directly:**
+1. Copy the `.json` file to the same directory on the target PC
+2. Restart OrcaSlicer → preset appears in the dropdown
+
+**Method B — OrcaSlicer import function:**
+1. In OrcaSlicer: **File → Import → Import Configs...**
+2. Select the `.json` file
+3. Restart OrcaSlicer
+
+> **Note:** The `filament_id` inside the file is preserved — the preset will be recognized on the target PC exactly as on the source PC.
+
+---
+
+## 4. Link the Preset in KX-Bridge
+
+1. Open the KX-Bridge UI
+2. Go to **Filament Management** → select the AMS slot
+3. In the **Filament Name** field, enter the OrcaSlicer preset name exactly:
+   ```
+   SUNLU PLA+ 2.0
+   ```
+4. Save
+
+The bridge sends `filament_name: "SUNLU PLA+ 2.0"` during sync → OrcaSlicer matches by name and `filament_id` → displays the preset correctly.
+
+---
+
+## Quick Reference
+
+| What | Why |
+|------|-----|
+| Name in OrcaSlicer and Bridge must match **exactly** | Case and special characters are compared |
+| Preset must be compatible with **Anycubic Kobra X 0.4 nozzle** | Select the correct printer when saving |
+| **Restart OrcaSlicer** after saving for the first time | The `filament_id` is only written persistently after a restart |
+| Use **OrcaSlicer-KX v2.4.0-alpha-kx2** or newer | Older versions do not generate a unique `filament_id` for user presets |
+
+---
+---
+
+# Cómo crear, verificar e importar perfiles de filamento personalizados para KX-Bridge
+
+> **Requiere:** OrcaSlicer-KX v2.4.0-alpha-kx2 o superior
+
+---
+
+## ¿Qué es el `filament_id` y por qué es importante?
+
+Cada perfil de filamento en OrcaSlicer tiene un `filament_id` interno. KX-Bridge usa este ID para asignar el perfil correcto durante la sincronización AMS.
+
+- Los perfiles del sistema (p. ej. "Polymaker PolyTerra PLA") tienen un ID fijo como `GFL99` o `OGFL04`.
+- Los **perfiles personalizados (usuario)** reciben automáticamente un ID único que empieza por `P` (p. ej. `P3a7f2c1`) en OrcaSlicer-KX.
+
+Sin un ID único, OrcaSlicer mostrará siempre "Generic PLA" durante la sincronización, aunque el perfil exista.
+
+---
+
+## 1. Crear un perfil de filamento personalizado
+
+1. Iniciar OrcaSlicer-KX
+2. Seleccionar un perfil base adecuado en el **menú desplegable de filamento** (p. ej. "Generic PLA" o un perfil de fabricante)
+3. Ajustar la configuración según sea necesario (temperaturas, refrigeración, etc.)
+4. Hacer clic en el **icono de guardar** (disquete) → **"Save as new preset"**
+5. Introducir un nombre — p. ej. `SUNLU PLA+ 2.0`
+   > Este nombre debe introducirse en la bridge exactamente igual.
+6. Seleccionar impresora: **Anycubic Kobra X 0.4 nozzle** — ¡necesario para la compatibilidad!
+7. Hacer clic en **Guardar**
+8. **Reiniciar OrcaSlicer una vez** — el `filament_id` solo se escribe de forma permanente tras un reinicio.
+
+---
+
+## 2. Verificar el ID único
+
+Tras reiniciar, comprobar que el ID se ha establecido correctamente:
+
+**Windows:**
+```
+%APPDATA%\OrcaSlicer\user\default\filament\SUNLU PLA+ 2.0.json
+```
+
+**Linux:**
+```
+~/.config/OrcaSlicer/user/default/filament/SUNLU PLA+ 2.0.json
+```
+
+Abrir el archivo y buscar `filament_id`:
+
+```json
+{
+  "filament_id": "P3a7f2c1",
+  ...
+}
+```
+
+✅ Correcto: el ID empieza por `P` seguido de 7 caracteres hexadecimales  
+❌ Falta o está vacío: la versión de OrcaSlicer-KX es demasiado antigua — actualizar a v2.4.0-alpha-kx2 o superior
+
+---
+
+## 3. Transferir un perfil a otro PC (importar)
+
+### Exportar (PC de origen)
+
+Simplemente copiar el archivo del perfil:
+
+**Windows:**
+```
+%APPDATA%\OrcaSlicer\user\default\filament\SUNLU PLA+ 2.0.json
+```
+
+**Linux:**
+```
+~/.config/OrcaSlicer/user/default/filament/SUNLU PLA+ 2.0.json
+```
+
+### Importar (PC de destino)
+
+**Método A — Copiar el archivo directamente:**
+1. Copiar el archivo `.json` al mismo directorio en el PC de destino
+2. Reiniciar OrcaSlicer → el perfil aparece en el menú desplegable
+
+**Método B — Función de importación de OrcaSlicer:**
+1. En OrcaSlicer: **File → Import → Import Configs...**
+2. Seleccionar el archivo `.json`
+3. Reiniciar OrcaSlicer
+
+> **Nota:** El `filament_id` dentro del archivo se conserva — el perfil se reconocerá en el PC de destino exactamente igual que en el de origen.
+
+---
+
+## 4. Vincular el perfil en KX-Bridge
+
+1. Abrir la interfaz de KX-Bridge
+2. Ir a **Gestión de filamentos** → seleccionar la ranura AMS
+3. En el campo **Nombre de filamento**, introducir el nombre exacto del perfil de OrcaSlicer:
+   ```
+   SUNLU PLA+ 2.0
+   ```
+4. Guardar
+
+La bridge envía `filament_name: "SUNLU PLA+ 2.0"` durante la sincronización → OrcaSlicer busca por nombre y `filament_id` → muestra el perfil correctamente.
+
+---
+
+## Referencia rápida
+
+| Qué | Por qué |
+|-----|---------|
+| El nombre en OrcaSlicer y en Bridge debe coincidir **exactamente** | Se comparan mayúsculas, minúsculas y caracteres especiales |
+| El perfil debe ser compatible con **Anycubic Kobra X 0.4 nozzle** | Seleccionar la impresora correcta al guardar |
+| **Reiniciar OrcaSlicer** tras guardar por primera vez | El `filament_id` solo se escribe de forma permanente tras un reinicio |
+| Usar **OrcaSlicer-KX v2.4.0-alpha-kx2** o superior | Las versiones anteriores no generan un `filament_id` único para perfiles de usuario |

kobrax_client.py

@@ -167,7 +167,8 @@ class KobraXClient:
         ctx.set_ciphers("DEFAULT:@SECLEVEL=0")
         ctx.load_cert_chain(CERT_FILE, KEY_FILE)
 
-        raw        = socket.create_connection((self.host, self.port), timeout=5)
+        _ai        = socket.getaddrinfo(self.host, self.port, socket.AF_INET, socket.SOCK_STREAM)
+        raw        = socket.create_connection(_ai[0][4], timeout=5)
         self._sock = ctx.wrap_socket(raw)
         log.info("TLS connected  cipher=%s", self._sock.cipher()[0])
 
@@ -596,7 +597,8 @@ class KobraXClient:
         # langsamerem WLAN am Drucker dauert das Schieben sonst >30 s und
         # würde den Connect-Timeout fälschlich auslösen. Read-Timeout danach
         # generös (Drucker verarbeitet die Datei bevor er antwortet).
-        sock = socket.create_connection((self.host, 18910), timeout=10)
+        _ai  = socket.getaddrinfo(self.host, 18910, socket.AF_INET, socket.SOCK_STREAM)
+        sock = socket.create_connection(_ai[0][4], timeout=10)
         sock.settimeout(None)  # blocking während Send
         sock.sendall(headers + body)
         sock.settimeout(180)

kobrax_moonraker_bridge.py

@@ -1906,10 +1906,12 @@ class KobraXBridge:
                         "square_corner_velocity":  20.0,
                     },
                     "extruder": {
-                        "nozzle_diameter":  0.4,
-                        "min_temp":         0,
-                        "max_temp":         320,
-                        "min_extrude_temp": 10,
+                        "nozzle_diameter":    0.4,
+                        "filament_diameter":  1.75,
+                        "sensor_type":        "ATC Semitec 104GT-2",
+                        "min_temp":           0,
+                        "max_temp":           320,
+                        "min_extrude_temp":   10,
                     },
                     "heater_bed": {
                         "min_temp": 0,

web/themes/default/app.js

@@ -7,6 +7,7 @@ var S={nozzle_temp:0,nozzle_target:0,bed_temp:0,bed_target:0,
 var tempHistory={n:[],b:[]};
 var camOn=false;
 var camUserStopped=false; // user stopped camera manually — suppress auto-restart for this print
+var _camPollInterval=null; // snapshot-polling interval for Android (no MJPEG support)
 var currentStep=1;
 var currentPanel='dashboard';
 var aceAutoRefillPrefs=(function(){
@@ -1501,23 +1502,24 @@ function camStart(){
   img.style.display='none';
   sp.style.display='block';
   post('/api/camera/start',{}).then(function(){
-    img.onerror=function(){
-      sp.style.display='none';
-      img.style.display='none';
-      ph.style.display='flex';
-      camOn=false;
-      document.getElementById('cam-toggle-btn').textContent=tr('btn_cam_start');
-      clog(tr('log_error')+' '+tr('cam_stream_unavailable'),'msg-err');
-    };
-    img.src='/api/camera/stream?t='+Date.now();
     camOn=true;
     document.getElementById('cam-toggle-btn').textContent=tr('btn_cam_stop');
     clog(tr('log_cam_start'),'msg-ok');
-    // MJPEG liefert kein onload – Spinner nach kurzem Timeout ausblenden
-    setTimeout(function(){
-      sp.style.display='none';
-      img.style.display='block';
-    },1200);
+    setTimeout(function(){ sp.style.display='none'; img.style.display='block'; },1200);
+    if(/Android/i.test(navigator.userAgent)){
+      // Android browsers don't support multipart/x-mixed-replace (MJPEG) — poll snapshots instead
+      _camPollInterval=setInterval(function(){ img.src='/api/camera/snapshot?t='+Date.now(); },200);
+    } else {
+      img.onerror=function(){
+        sp.style.display='none';
+        img.style.display='none';
+        ph.style.display='flex';
+        camOn=false;
+        document.getElementById('cam-toggle-btn').textContent=tr('btn_cam_start');
+        clog(tr('log_error')+' '+tr('cam_stream_unavailable'),'msg-err');
+      };
+      img.src='/api/camera/stream?t='+Date.now();
+    }
   }).catch(function(e){
     sp.style.display='none';
     ph.style.display='flex';
@@ -1527,6 +1529,7 @@ function camStart(){
 
 function camStop(){
   var img=document.getElementById('cam-img');
+  if(_camPollInterval){clearInterval(_camPollInterval);_camPollInterval=null;}
   img.onerror=null; // deregister error handler before clearing src to avoid spurious error toast
   post('/api/camera/stop',{}).catch(function(){});
   img.src='';