chore: reset NIGHTLY_CHANGELOG.md after nightly-0.9.30-nightly12 release

A testing-<sha> build has no Gitea releases (the testing workflow builds only
a Docker image), so the in-app update check must not fall through to the
stable path - which would wrongly offer a stable "update". handle_api_update_check
now short-circuits for a "testing" version with docker_only:true and nothing
to update (no Gitea round-trip at all), and handle_api_update_apply refuses
self-update on the testing channel the same way it already does for nightly.

Two new tests cover both. (Mirrors the same fix already on the testing
branch, applied here to the pre-refactor monolithic module.)

.gitea/make_release_json.py

@@ -0,0 +1,12 @@
+#!/usr/bin/env python3
+import sys, json
+tag, version, body_file = sys.argv[1], sys.argv[2], sys.argv[3]
+body = open(body_file).read()
+payload = json.dumps({
+    "tag_name": tag,
+    "name": "KX-Bridge " + version + " Nightly",
+    "body": body,
+    "draft": False,
+    "prerelease": True
+})
+open("/tmp/release_body.json", "w").write(payload)

.gitea/workflows/nightly.yml

@@ -68,7 +68,8 @@ jobs:
       - name: Compute nightly version
         run: |
           # Letzten Stable-Tag ermitteln (v0.9.27 → minor=27)
-          LAST_STABLE=$(git tag --list 'v*' --sort=-version:refname | head -1)
+          LAST_STABLE=$(git tag --list 'v*' --sort=-version:refname \
+            | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+' | { read -r line; echo "$line"; cat >/dev/null; } || true)
           if [ -z "$LAST_STABLE" ]; then
             echo "ERROR: kein Stable-Tag gefunden" >&2; exit 1
           fi
@@ -93,7 +94,7 @@ jobs:
           # VERSION-Datei im Arbeitsverzeichnis für den Docker-Build setzen (kein Commit)
           echo "$VERSION" > VERSION
           docker buildx build \
-            --platform linux/amd64,linux/arm64 \
+            --platform linux/amd64,linux/arm64,linux/arm/v7 \
             --push \
             --provenance=false \
             --no-cache \
@@ -108,19 +109,30 @@ jobs:
           . /tmp/nightly_version.env
           TAG="nightly-${VERSION}"
 
-          # Letzten nightly-Tag als Changelog-Basis ermitteln
-          PREV_TAG=$(git tag --list 'nightly-*' --sort=-version:refname | head -1)
-          [ -z "$PREV_TAG" ] && PREV_TAG="$LAST_STABLE"
+          # Letzten Stable-Tag als Changelog-Basis (nur echte vX.Y.Z-Tags)
+          PREV_TAG=$(git tag --list 'v*' --sort=-version:refname \
+            | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' \
+            | { read -r line; echo "$line"; cat >/dev/null; } || true)
+          [ -z "$PREV_TAG" ] && PREV_TAG=$(git rev-list --max-parents=0 HEAD)
 
-          # Changelog generieren
+          # Changelog: NIGHTLY_CHANGELOG.md hat Vorrang (manuell gepflegt),
+          # sonst auto-generiert aus feat/fix-Commits seit letztem Stable-Tag
           BODY_FILE=$(mktemp)
           printf '## KX-Bridge %s — Nightly Build\n\n' "$VERSION" > "$BODY_FILE"
           printf '[experimental] Untested features, for testers only.\n\n' >> "$BODY_FILE"
-          printf '### Changes since `%s`\n\n' "$PREV_TAG" >> "$BODY_FILE"
-          git log "${PREV_TAG}..HEAD" --pretty=format:'- %s' \
-            --no-merges \
-            --invert-grep --grep='^chore: nightly' \
-            >> "$BODY_FILE" || true
+          if [ -s NIGHTLY_CHANGELOG.md ]; then
+            cat NIGHTLY_CHANGELOG.md >> "$BODY_FILE"
+          else
+            printf '### Changes since `%s`\n\n' "$PREV_TAG" >> "$BODY_FILE"
+            git log "${PREV_TAG}..HEAD" --pretty=format:'%s' --no-merges \
+              | grep -E '^(feat|fix)[:(]' \
+              | grep -Ev '^(feat|fix)\((ci|release|build|workflow)\)' \
+              | sed 's/^/- /' \
+              >> "$BODY_FILE" || true
+            if ! grep -q '^- ' "$BODY_FILE"; then
+              printf '- No user-facing changes in this build\n' >> "$BODY_FILE"
+            fi
+          fi
           printf '\n\n---\n\n### Update Docker image\n\n```bash\ndocker compose pull && docker compose up -d\n```\n\n' >> "$BODY_FILE"
           printf 'Image tag: `gitea.it-drui.de/viewit/kx-bridge:nightly`\n' >> "$BODY_FILE"
 
@@ -128,13 +140,20 @@ jobs:
           git tag "$TAG"
           git push https://gitea-actions:${GITEA_TOKEN}@gitea.it-drui.de/viewit/KX-Bridge-Release.git "$TAG"
 
-          # curl installieren falls nötig
+          # curl + jq installieren falls nötig
           if ! command -v curl >/dev/null 2>&1; then
             apk add --no-cache curl 2>/dev/null || \
               { wget -qO /usr/local/bin/curl \
                   "https://github.com/moparisthebest/static-curl/releases/download/v8.6.0/curl-amd64" \
                 && chmod +x /usr/local/bin/curl; }
           fi
+          if ! command -v jq >/dev/null 2>&1; then
+            ARCH=$(uname -m)
+            JQ_ARCH="amd64"; [ "$ARCH" = "aarch64" ] && JQ_ARCH="arm64"
+            wget -qO /usr/local/bin/jq \
+              "https://github.com/jqlang/jq/releases/download/jq-1.7.1/jq-linux-${JQ_ARCH}"
+            chmod +x /usr/local/bin/jq
+          fi
 
           # Altes Release löschen falls vorhanden
           curl -s -X DELETE \
@@ -142,16 +161,33 @@ jobs:
             "https://gitea.it-drui.de/api/v1/repos/viewit/KX-Bridge-Release/releases/tags/${TAG}" \
             2>/dev/null || true
 
-          # Release erstellen
-          BODY_JSON=$(awk '{
-            gsub(/\\/, "\\\\"); gsub(/"/, "\\\""); gsub(/\t/, "\\t");
-            printf "%s\\n", $0
-          }' "$BODY_FILE" | awk 'BEGIN{printf "\""} {printf "%s", $0} END{printf "\""}')
-          JSON_PAYLOAD="{\"tag_name\":\"${TAG}\",\"name\":\"KX-Bridge ${VERSION} Nightly\",\"body\":${BODY_JSON},\"draft\":false,\"prerelease\":true}"
-          printf '%s' "$JSON_PAYLOAD" > /tmp/release_body.json
+          # Release erstellen — JSON sicher via jq bauen
+          jq -n \
+            --arg tag "$TAG" \
+            --arg name "KX-Bridge ${VERSION} Nightly" \
+            --rawfile body "$BODY_FILE" \
+            '{"tag_name":$tag,"name":$name,"body":$body,"draft":false,"prerelease":true}' \
+            > /tmp/release_body.json
           curl -s -X POST \
             -H "Authorization: token ${GITEA_TOKEN}" \
             -H "Content-Type: application/json" \
             --data-binary @/tmp/release_body.json \
             "https://gitea.it-drui.de/api/v1/repos/viewit/KX-Bridge-Release/releases"
           rm -f "$BODY_FILE" /tmp/release_body.json
+
+      - name: Reset NIGHTLY_CHANGELOG.md for the next build
+        env:
+          GITEA_TOKEN: ${{ secrets.RELEASE_TOKEN }}
+        run: |
+          . /tmp/nightly_version.env
+          # The changelog just consumed above must not carry over into the
+          # next nightly - otherwise every build re-lists all prior entries
+          # since the last manual reset instead of just what's new. Not in
+          # nightly.yml's own push-trigger paths, so this commit does not
+          # re-trigger this workflow.
+          printf '## Changes in this build\n\n' > NIGHTLY_CHANGELOG.md
+          git config user.name "gitea-actions"
+          git config user.email "actions@gitea.it-drui.de"
+          git add NIGHTLY_CHANGELOG.md
+          git commit -m "chore: reset NIGHTLY_CHANGELOG.md after nightly-${VERSION} release" || exit 0
+          git push https://gitea-actions:${GITEA_TOKEN}@gitea.it-drui.de/viewit/KX-Bridge-Release.git HEAD:nightly

.gitea/workflows/release.yml

@@ -61,7 +61,7 @@ jobs:
         run: |
           VERSION="${GITHUB_REF#refs/tags/v}"
           docker buildx build \
-            --platform linux/amd64,linux/arm64 \
+            --platform linux/amd64,linux/arm64,linux/arm/v7 \
             --push \
             --provenance=false \
             --no-cache \

API.md

@@ -0,0 +1,256 @@
+# KX-Bridge HTTP API Reference
+
+This document lists the HTTP and WebSocket surface exposed by
+`kobrax_moonraker_bridge.py`. It is a reference for integrators and
+plugin authors, not a tutorial — for day-to-day usage of the bridge see
+[MANUAL.md](MANUAL.md), and for setup see [README.md](README.md).
+
+The API has two distinct parts:
+
+1. **Moonraker-compatible surface** — a subset of the real
+   [Moonraker](https://moonraker.readthedocs.io/) HTTP + WebSocket API,
+   implemented just far enough to make Mainsail, Fluidd, OrcaSlicer, and
+   `moonraker-obico` work against the Kobra X. **This is not a full
+   Moonraker implementation** — many real Moonraker endpoints/methods do
+   not exist here, and some responses are static stubs that exist only
+   to stop a client from erroring/looping (noted below).
+2. **Bridge-specific surface** — `/api/...` and `/kx/...` endpoints for
+   things Moonraker has no concept of: multi-printer management, AMS/ACE
+   filament control, the GCode store, custom filament profile import,
+   Spoolman, and the smart-plug power switch.
+
+## Security
+
+**There is no authentication on any endpoint.** The bridge is designed
+to be run on a trusted local network only. Do not expose port `7125`
+(or any additional per-printer port) to the internet — anyone who can
+reach the port can control the printer, read/delete files, and read
+`/kx/printers` credentials indirectly through bridge behavior. `/access/api_key`
+returns a hardcoded dummy value purely so `moonraker-obico` doesn't warn;
+it is not a real credential.
+
+CORS is enabled (`_json_cors` / `handle_kx_options` add
+`Access-Control-Allow-*` headers and answer `OPTIONS` with 204) so the
+Web UI can call sibling bridge instances directly in multi-printer setups.
+
+---
+
+## Moonraker-compatible endpoints (HTTP)
+
+All responses follow Moonraker's `{"result": {...}}` envelope unless noted.
+
+| Method | Path | Purpose | Notes |
+|---|---|---|---|
+| GET | `/server/info` | Server/klippy status | Always reports `klippy_connected: true`, `klippy_state: "ready"` |
+| GET | `/printer/info` | Printer identity | Static hostname/paths; `software_version` from `KLIPPER_VERSION` |
+| GET | `/machine/system_info` | System info stub | Mostly static/placeholder fields |
+| GET | `/printer/objects/list` | List available printer objects | Keys of `_build_printer_objects()` |
+| GET | `/printer/objects/query?objects=...` | Query object status | Comma-separated `objects` query param, or bare query keys |
+| GET`/POST` | `/printer/objects/subscribe` | Subscribe (HTTP polling variant) | Returns full status snapshot immediately |
+| GET | `/server/files/list` | List gcode files | Only returns the single currently-tracked file (if any) |
+| GET | `/server/files/metadata?filename=...` | File metadata (layers, est. time, etc.) | Shared logic with WS `server.files.metadata`; falls back to GCode store / buried-report cache |
+| POST | `/server/files/upload` | Upload a gcode file (multipart) | Same handler as `/api/files/local` |
+| POST | `/printer/print/start?filename=...` | Start a print | Body may include `filament_assignments`, `excluded_objects`, `auto_leveling` |
+| POST | `/printer/print/pause` | Pause current print | |
+| POST | `/printer/print/resume` | Resume current print | |
+| POST | `/printer/print/cancel` | Cancel current print | |
+| GET | `/access/api_key` | Dummy API key | No real auth exists |
+| GET | `/machine/update/status` | Update-manager stub | Always `busy: false`, empty `version_info` |
+| GET | `/server/history/list?limit=` | Print job history | Backed by the bridge's own GCodeStore/job DB |
+| GET | `/server/webcams/list` | Webcam descriptor | Rewrites `localhost`/`127.0.0.1` Host header to the bridge's LAN IP so remote Obico/Mainsail instances get a reachable URL |
+| POST | `/printer/gcode/script` | Execute a (very limited) gcode command | See `_exec_gcode_script`; not a general gcode interpreter |
+| GET | `/server/database/item?namespace=&key=` | Moonraker "database" KV read | Real payload only for `lane_data` (AMS/filament sync for OrcaSlicer); stub/empty responses for `AFC`, `afc-install`, `happy_hare`, `mainsail`; in-memory KV for `obico` |
+| POST | `/server/database/item` | Moonraker "database" KV write | In-memory only (not persisted across restarts); used by `moonraker-obico` for its own settings |
+| GET | `/server/database/list` | List KV namespaces | Static: `["lane_data", "mainsail", "obico"]` |
+
+### OctoPrint-compatibility shim
+
+| Method | Path | Purpose |
+|---|---|---|
+| GET | `/api/version` | OctoPrint-style version probe (some tools check this instead of Moonraker) |
+| POST | `/api/files/local`, `/api/files/{path}` | Alias for the same multipart upload handler as `/server/files/upload` |
+
+### WebSocket JSON-RPC (`/websocket`)
+
+Moonraker's JSON-RPC 2.0 protocol over a single `/websocket` endpoint. On
+connect the bridge immediately pushes `notify_klippy_ready` and then
+periodic `notify_status_update` notifications. Supported `method` values:
+
+| Method | Purpose |
+|---|---|
+| `printer.info` / `printer_info` | Same payload as `/printer/info` |
+| `server.info` / `server_info` | Same payload as `/server/info` |
+| `printer.objects.list` | Same as HTTP equivalent |
+| `printer.objects.query` / `printer.objects.get` | Object status by requested keys |
+| `printer.objects.subscribe` | Returns a status snapshot (no real push subscription semantics — status pushes happen automatically via `notify_status_update`) |
+| `printer.print.start` | `params.filename` |
+| `printer.print.pause` / `.resume` / `.cancel` | |
+| `machine.system_info` | Minimal stub |
+| `server.files.list` | Always returns `[]` over WS (unlike the HTTP version) |
+| `printer.gcode.script` | `params.script`, same limited executor as the HTTP endpoint |
+| `server.connection.identify` | Returns a dummy `connection_id` for Obico's handshake |
+| `connection.register_remote_method` | Accepted and ignored (Obico registers a remote-event callback) |
+| `server.webcams.list` | Same shape as HTTP, using the bridge's own LAN IP |
+| `server.history.list` | Job history, same source as `/server/history/list` |
+| `machine.update.status` | Stub |
+| `server.files.metadata` | Same logic as `/server/files/metadata` |
+
+Any other method is logged and answered with an empty `result: {}` — it
+does not error, to avoid breaking clients that probe for optional
+methods.
+
+---
+
+## Bridge-specific endpoints
+
+All `/kx/...` (and most `/api/...`) responses use `{"result": ...}` on
+success and `{"error": "..."}` with a 4xx/5xx status on failure, except
+where noted.
+
+### Printer control (`/api/...`)
+
+| Method | Path | Purpose | Body / Query |
+|---|---|---|---|
+| POST | `/api/light` | Toggle chamber light | `{on, brightness}` |
+| POST | `/api/fan` | Set part-cooling fan speed | `{speed}` (0–100) |
+| POST | `/api/connect` | Manually (re)connect the MQTT client | — |
+| POST | `/api/disconnect` | Manually disconnect | — |
+| POST | `/api/restart` | Restart the bridge process | — |
+| POST | `/api/speed` | Set print speed mode | `{mode}` (int) |
+| POST | `/api/axis` | Jog an axis, or `{"action":"turnoff"}` to disable steppers | `{axis, move_type, distance}` |
+| POST | `/api/temperature` | Set nozzle/bed target temps | `{nozzle?, bed?}`; uses a different MQTT path mid-print vs. idle |
+| GET | `/api/state` | Full dashboard status snapshot | Primary polling endpoint used by the Web UI |
+| GET | `/api/camera` | Current camera stream URL | |
+| GET | `/api/camera/stream` | MJPEG live view | `multipart/x-mixed-replace`, fed from a shared ffmpeg fanout |
+| GET | `/api/camera/h264` | Raw H.264 stream (for Obico) | |
+| GET | `/api/camera/snapshot` | Last cached JPEG frame | Instant, served from RAM |
+| POST | `/api/camera/start` / `/api/camera/stop` / `/api/camera/reset` | Camera lifecycle control | `reset` clears the 429 backoff and restarts ffmpeg |
+| GET | `/api/settings` | Read current config.ini-backed settings | |
+| POST | `/api/settings` | Write settings, then restart the bridge | See config fields below |
+| GET | `/api/update/check` | Check Gitea releases for a newer version | Branches on nightly/dev/stable channel |
+| POST | `/api/update/apply` | Self-update (non-Docker builds only) | `{tag}` |
+| POST | `/api/file_ready/clear` | Dismiss the "file ready to print" banner/dialog state | |
+| GET | `/api/log/stream` | Server-Sent Events log tail | |
+| GET | `/api/log/download` | Download buffered log as plaintext | |
+| GET | `/serve/{filename}` | Internal file server used to hand the printer a URL to fetch gcode from | Not meant for direct browser use |
+
+**`/api/settings` fields** (POST body, all optional — merges into
+existing config.ini): `printer_ip`, `mqtt_port`, `username`, `password`,
+`mode_id`, `device_id`, `power_on_url`, `power_off_url`,
+`power_status_url`, `default_ams_slot`, `auto_leveling`,
+`vibration_compensation`, `camera_on_print`, `web_upload_warning`,
+`print_start_dialog`, `poll_interval`, `verbose_http_log`,
+`printer_name`, `spoolman_server`, `spoolman_sync_rate`,
+`ace_dry_presets`.
+
+### AMS / ACE filament control (`/api/...`)
+
+| Method | Path | Purpose | Body |
+|---|---|---|---|
+| POST | `/api/ams/set_slot` | Set material type + color for a slot | `{index, type, color:[r,g,b]}` |
+| POST | `/api/ams/feed` | Feed filament in/out | `{slot_index, type}` (1=feed in, 2=feed out) |
+| POST | `/api/ace/auto_feed` | Toggle auto-feed for an ACE unit | `{ace_id, on}` |
+| POST | `/api/ace/dry` | Start/stop the ACE dryer | `{action: "start"|"stop", ace_id?, target_temp?, duration?}` |
+
+### GCode store (bridge-managed uploads) (`/kx/files...`)
+
+| Method | Path | Purpose |
+|---|---|---|
+| GET | `/kx/files` | List files the bridge has stored, with last-print status/duration |
+| DELETE | `/kx/files/{file_id}` | Delete a stored file |
+| GET | `/kx/files/{file_id}/download` | Download a stored file |
+| POST | `/kx/files/{file_id}/verify` | Clear the "web upload, unverified" flag |
+| GET | `/kx/files/{id}/objects` | Print-object list + SVG preview (for the pre-print skip feature) |
+| GET | `/kx/history?limit=&offset=` | Paginated print job history |
+
+### Files on the printer's own storage (`/kx/printer-files...`)
+
+Distinct from the GCode store above — these list/manage files that live
+on the printer's internal storage (e.g. printed directly from Anycubic
+Slicer Next, bypassing the bridge).
+
+| Method | Path | Purpose |
+|---|---|---|
+| GET | `/kx/printer-files` | List files via the printer's `file/listLocal` MQTT action |
+| POST | `/kx/printer-files/delete` | Delete one or more files: `{"filenames": [...]}` (single endpoint for single + bulk delete) |
+| GET | `/kx/printer-files/{filename}/thumbnail` | Fetch (and cache) a file's embedded gcode thumbnail via `file/fileDetails` |
+
+### Printing (`/kx/print`)
+
+| Method | Path | Purpose | Body |
+|---|---|---|---|
+| POST | `/kx/print` | Start a print from a stored GCode-store file | `{file_id, filament_assignments?, excluded_objects?, auto_leveling?}` |
+
+`filament_assignments` is `[{slot_index, material, color_hex}, ...]`; if
+omitted, all currently-occupied AMS slots are auto-mapped.
+
+### Pre-print / mid-print object skip (`/kx/skip...`)
+
+| Method | Path | Purpose |
+|---|---|---|
+| POST | `/kx/skip` | Skip named objects mid-print: `{"names": [...]}` |
+| POST | `/kx/skip/query` | Re-request the object list from the printer and return merged skip state |
+| GET | `/kx/skip/state` | Current skip state (object list, already-skipped names, SVG, filename) |
+
+### Filament profiles (`/kx/filament/...`)
+
+| Method | Path | Purpose | Body / Query |
+|---|---|---|---|
+| GET | `/kx/filament/slots` | Current AMS slot contents + any user profile override | |
+| GET | `/kx/filament/profiles?type=&vendor=` | Curated OrcaSlicer filament profile catalog (system + user-imported) | Optional filters |
+| GET | `/kx/filament/profiles/user` | User-imported profiles only (for the settings management list) | |
+| POST | `/kx/filament/profiles/user` | Import profiles from a ZIP or `.json` file(s) (multipart) | Multipart field `file`/`files`/`upload`; ZIP entries or bare `.json`, parsed via `orca_filaments.parse_profile_bytes` |
+| DELETE | `/kx/filament/profiles/user?vendor=&name=` | Delete one user profile (both params) or all (no params) | |
+| POST | `/kx/filament/slots/{idx}/profile` | Assign (or clear) a fixed profile override for one AMS slot | `{vendor, name}`; empty strings clear the mapping. Selector is `(vendor, name)`, not `id` — IDs are not unique across the Orca profile catalog |
+| GET`/POST` | `/kx/filament/visible_vendors` | Get/set the vendor visibility filter for the slot profile dropdown | POST body `{"vendors": [...]}`; empty list = show all |
+
+### Spoolman integration (`/kx/spoolman/...`)
+
+| Method | Path | Purpose |
+|---|---|---|
+| GET | `/kx/spoolman/status` | Whether Spoolman is configured/reachable, server URL, sync rate, current slot→spool map |
+| GET | `/kx/spoolman/spools` | Proxied list of spools from the configured Spoolman server |
+| POST | `/kx/spoolman/active-spool` | Assign spool IDs to AMS slots: `{"slot_map": {"0": 42, "2": 17}}` (AMS slot index → Spoolman spool ID) |
+
+### Multi-printer management (`/kx/printers...`)
+
+| Method | Path | Purpose | Body |
+|---|---|---|---|
+| GET | `/kx/printers` | List all configured printers with online-ish metadata | |
+| POST | `/kx/printers/add` | Add a printer by IP (credentials auto-fetched from the printer) | `{printer_ip, name?}` — triggers a bridge restart |
+| DELETE | `/kx/printers/{pid}` | Remove a printer from config; renumbers remaining `[printer_N]` sections | — triggers a bridge restart |
+| POST | `/kx/printers/{pid}/power` | Toggle an external smart plug (Tasmota-style) for a printer | `{"action": "on"|"off"}` |
+| GET | `/kx/printers/{pid}/power-status` | Query the smart plug's current on/off state | |
+
+**Power switch is not the printer's own power state** — it's a plain
+`GET` fired at a user-configured `power_on_url` / `power_off_url` /
+`power_status_url` (e.g. a Tasmota `cmnd=Power%20on` URL). See
+[MANUAL.md](MANUAL.md#power-switch-feature) for details.
+It only exists for printers where `power_on_url` or `power_off_url` is
+set in config; `/kx/printers` exposes this as `has_power_control`.
+
+### Misc
+
+| Method | Path | Purpose |
+|---|---|---|
+| GET | `/kx/ui/{name}` | Serves theme assets (JS/CSS/vendored libs) and translation JSON files under the active UI theme |
+| GET | `/` , `/printer{N}` | Serves the Web UI (index.html with CSS/JS inlined for embedded-webview compatibility, e.g. OrcaSlicer's device tab) |
+| GET | `/favicon.ico` | Favicon |
+
+---
+
+## Response conventions
+
+- Moonraker-compatible endpoints wrap results as `{"result": {...}}` (or
+  `{"error": {"code": ..., "message": ...}}` for the `/server/database/*`
+  404 case) to match the real Moonraker schema.
+- Bridge-specific `/api/...` and `/kx/...` endpoints generally return
+  `{"result": ...}` on success and `{"error": "message"}` with a
+  non-2xx HTTP status on failure — but this is not universal; check the
+  handler in `kobrax_moonraker_bridge.py` if exact shape matters (route
+  registrations are near the end of the file, search for
+  `r.add_get(`/`r.add_post(`/`r.add_delete(`).
+- Endpoints that trigger a config write (`/api/settings`,
+  `/kx/printers/add`, `/kx/printers/{pid}` DELETE) restart the whole
+  bridge process shortly after responding — clients should expect a
+  brief connection drop.

CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## [Unreleased]
+
+### Fixed
+- **Slot kept showing/printing a stale filament type after a spool swap.** The
+  per-slot profile override (config.ini `[filament_profiles]`) stores only
+  vendor+name and was sticky: swapping the physical filament updated the AMS
+  colour and type live, but the saved profile persisted, so a slot that held
+  e.g. "KINGROON PETG Basic" kept showing/sending PETG in the panel and the
+  OrcaSlicer lane hint even after yellow PLA was loaded — and survived restarts.
+  The override is now applied only while its material *family* still matches the
+  loaded AMS material (PLA / PLA+ / PLA SILK / PLA MATTE are one family, so
+  within-family swaps never invalidate a valid profile). On a family change the
+  slot falls back to the generic default; the override is not deleted, so
+  reloading the original material reactivates it.
+- **Filament profiles not isolated between printers in a multi-printer bridge**
+  (issue #74). The slot→profile mapping and `visible_vendors` were stored in a
+  single global `[filament_profiles]` section, so configuring one printer
+  overwrote the other and after a restart both loaded the same mapping. Each
+  printer now persists to its own `[filament_profiles_<id>]` section, with a
+  read-fallback to the legacy global section (single-printer setups unchanged).
+- **Printer dropdown showed the other printer's filament profiles** (issue #74).
+  The header dropdown and the printers-management "switch" link navigated within
+  the same port (`/printerN`), so viewing another printer pulled its profile
+  names cross-instance from the local origin. The links now point at each
+  printer's own `bridge_url`, so every printer is viewed same-origin on its own
+  port.
+
 ## [0.9.26] – 2026-06-21
 
 ### New

Dockerfile

@@ -2,10 +2,11 @@ FROM python:3.11-slim-bookworm
 
 WORKDIR /app
 
-RUN apt-get update && apt-get install -y --no-install-recommends ffmpeg && rm -rf /var/lib/apt/lists/*
+RUN apt-get update && apt-get install -y --no-install-recommends ffmpeg gcc python3-dev && rm -rf /var/lib/apt/lists/*
 
 COPY requirements.txt .
-RUN pip install --no-cache-dir -r requirements.txt
+RUN pip install --no-cache-dir -r requirements.txt && \
+    apt-get purge -y gcc python3-dev && apt-get autoremove -y && rm -rf /var/lib/apt/lists/*
 
 COPY kobrax_moonraker_bridge.py .
 COPY web/ ./web/

MANUAL.md

@@ -0,0 +1,330 @@
+# KX-Bridge User Manual
+
+This is a day-to-day how-to guide for using KX-Bridge once it's running.
+For installing/updating the bridge itself, see [README.md](README.md).
+For the HTTP/WebSocket API (developers, plugin authors, integrators), see
+[API.md](API.md).
+
+---
+
+## Getting Started
+
+### Install and start the bridge
+
+Follow the Quick Start in [README.md](README.md#-quick-start) — the short
+version is:
+
+```bash
+docker compose up -d
+```
+
+then open `http://BRIDGE-IP:7125` in a browser.
+
+### Connect to your printer for the first time
+
+1. On the printer's display: **Settings → Enable LAN mode**.
+2. In the bridge Web UI, the **Printers** tab shows **"+ Add printer"** on
+   first start. Click it, enter the printer's IP address, and confirm —
+   username, password and device ID are fetched from the printer and
+   decrypted automatically. No manual credential entry needed.
+3. Click **⚡ Connect** in the top-right corner to open the
+   connection. The status badge next to it shows the current printer state
+   (Standby, Printing, …).
+
+### Connect OrcaSlicer
+
+In OrcaSlicer, set the printer's connection type to **Moonraker** and enter
+`http://BRIDGE-IP:7125` as the host (full URL including `http://` and the
+port). See the [Recommended Slicer](README.md#-recommended-slicer) section
+of the README for the patched OrcaSlicer-KX build with proper per-slot
+filament matching.
+
+---
+
+## Dashboard Overview
+
+The Dashboard is the main screen and is made of movable/resizable tiles
+("cards"). Click **🖉 Customize dashboard** (top right
+of the dashboard) to enter edit mode: drag tiles to reorder, drag corners to
+resize, then save the arrangement as a named **preset** via the preset
+dropdown, or reset back to the default layout.
+
+The default tiles are:
+
+- **Camera** — live view from the printer's camera, with a light toggle and
+  a play/stop button. A small ↺ reset button appears if the stream needs to
+  reconnect (e.g. after a 429 rate-limit from the printer).
+- **Progress** — print percentage, a thumbnail of the current file, current
+  layer, current Z-height, elapsed/remaining time, and the file name.
+  While printing this card shows **Pause**, **Objects** (partial cancel, see
+  [Printing](#printing)) and **Stop** buttons. When a file is loaded but not
+  yet started, it instead shows **Print**, **Assign Slots**, and **Clear**.
+- **Temperatures** — current and target nozzle/bed temperature with
+  progress bars, quick "Set"/"Off" controls, and a rolling history chart of
+  the last 60 readings.
+- **Axis control** — jog buttons for X/Y/Z, adjustable step size (0.1 / 1 /
+  5 / 10 mm or a custom value), Home XY, Home Z, Home All, and Motors Off.
+- **Print Speed** — three presets (Quiet / Normal / Sport) matching the
+  printer's own speed modes.
+- **Fan** — a slider plus quick buttons (0/25/50/75/100%) for the part-cooling
+  fan.
+- **Filament / AMS** — one tile per AMS/ACE slot showing assigned material,
+  color and (if configured) the mapped OrcaSlicer profile. Click a slot to
+  open its edit dialog (see [Managing Filaments](#managing-filaments)).
+  If an ACE dryer is attached and active, a separate drying-status row
+  appears below the grid.
+
+Two banners can appear above the dashboard: an upload-ready banner when a
+GCode file finishes uploading (with Print / Assign Slots / Cancel actions),
+and a pause-reason banner when the printer pauses itself (e.g. filament
+runout).
+
+---
+
+## Printing
+
+### Uploading GCode
+
+Open the **Browser** tab (sidebar) → **Uploaded** sub-tab, and
+either drag a `.gcode`/`.bgcode` file onto the drop zone or click it to pick
+a file. Uploaded files get thumbnails (if embedded by the slicer), a search
+box, a status filter (All / Successful / Failed / New) and a sort order
+(date, name, print duration). Select the checkbox on a card to enter
+multi-select mode for bulk deletion.
+
+If you configured file-ready mode as "Print dialog" (see
+[Settings Reference](#settings-reference)), a dialog opens right after
+upload offering to start the print immediately or assign AMS slots first.
+With "banner" mode you instead get a persistent banner at
+the top of the screen with the same choices, so you can keep browsing
+before deciding.
+
+### Starting a print / assigning filament
+
+When starting a file that uses multiple filament channels (AMS/ACE slots),
+the **filament assignment dialog** opens automatically (or via "Assign
+Slots"). It lets you:
+
+- Map each GCode filament channel to a physical AMS/ACE slot, with a
+  mismatch warning if a channel's expected material/color doesn't match
+  what's actually loaded in the slot you pick.
+- Expand **✂ Skip objects** to deselect specific
+  printable objects (for multi-object plates) before the print starts —
+  the same object list and skip mechanism is also available mid-print from
+  the Progress card's "Objects" button.
+- Toggle **Auto-Leveling** for this print.
+- If Spoolman is configured, assign a specific spool to each slot right
+  from this dialog.
+
+Confirm with **▶ Print** to send the job to the printer.
+
+### Print-start behavior settings
+
+Under **Settings → Printer** you can control default behavior for
+every print:
+
+- **Default slot (single-color print)** —
+  which AMS slot to use automatically for single-material files.
+- **Auto-leveling before print** — run bed leveling before every print.
+- **Resonance compensation before print** — run input-shaper calibration
+  before every print.
+- **After upload: print-start behavior**
+  — dialog vs. banner, as described above.
+- **Turn camera on at print start** —
+  auto-start the camera stream whenever a print begins.
+- **Show warning for web-upload
+  prints** — an extra confirmation step for files uploaded through the
+  browser rather than sliced directly for this printer, to catch
+  wrong-printer-profile mistakes.
+
+### While printing
+
+The Progress card provides **Pause/Resume**, **Stop** (with a confirmation
+prompt), and **Objects** to skip specific objects on a multi-object plate
+mid-print.
+
+---
+
+## Managing Filaments
+
+### AMS / ACE slots
+
+Each slot tile on the Dashboard can be opened (click it) to edit:
+
+- **Color** — via a color picker, recent-color swatches, or "copy color
+  from slot" to match another slot.
+- **Material** — quick buttons for common materials, or free text.
+- **OrcaSlicer profile override** — pick a specific imported or built-in
+  OrcaSlicer filament profile for this slot. This is what gets sent to the
+  slicer during AMS sync instead of a generic "Generic PLA/PETG" fallback
+  (see the README's [OrcaSlicer-KX](README.md#-recommended-slicer) section
+  for why this matters).
+- A **feed** button to extrude/load filament for that slot directly from
+  the UI.
+
+If your printer has an ACE dryer unit, an additional drying panel appears
+below the AMS grid when drying is active, and slot edit dialogs let you
+configure drying **presets**: PLA, PLA+, PETG, TPU, ABS/ASA, PA/PC, and
+three freely-nameable Custom presets, each with its own temperature
+(30–80 °C) and remaining-time (h:m:s) setting. Presets can be edited and
+saved, or reset back to their defaults.
+
+### Importing your own OrcaSlicer profiles
+
+Under **Settings → Filament → OrcaSlicer-Profile** (or from the "★ Own
+profiles" link inside a slot's profile dropdown), open the import dialog
+and either drag a **ZIP** of your OrcaSlicer filament folder onto the drop
+zone, or upload individual **.json** profile files. In OrcaSlicer, that
+folder is reachable via **Help → Show Configuration Folder →
+user/<id>/filament/**. Imported profiles show up in every slot's profile
+dropdown under a "★ Own profiles" group and can be removed again from the
+same import dialog's list.
+
+### Filament-profile mapping and visible vendors
+
+Still under **Settings → Filament**:
+
+- **Filament profile mapping (per
+  slot)** — pin a fixed OrcaSlicer profile to each AMS slot so the bridge
+  always reports that profile during slicer sync, regardless of what
+  material/color is currently loaded.
+- **Visible vendors** — restrict which vendors show
+  up in the slot profile dropdown (useful if you only ever use a handful of
+  brands); leaving nothing selected shows all vendors. "Generic" and your
+  own imported profiles are always visible regardless of this filter.
+
+### Spoolman integration
+
+Configure the Spoolman server URL under **Settings → Integrations →
+Spoolman** (e.g. `http://spoolman:7912`) and a sync rate in seconds (`0`
+means "sync only when a print finishes"). Once connected, a
+**Spoolman — Slot assignment** panel appears under
+**Settings → Filament**, letting you assign a specific spool from your
+Spoolman inventory to each AMS slot. Filament usage is then tracked and
+reported to Spoolman automatically as you print, and the filament
+assignment dialog shown when starting a print also lets you pick/confirm
+spools per slot at print time.
+
+---
+
+## Multi-Printer Setup
+
+KX-Bridge can manage several printers from one running instance.
+
+- **Add a printer:** go to the **Printers** tab and click
+  **"+ Add printer"**. Enter the IP (name is
+  optional); credentials are fetched automatically, same as during first
+  setup. Each additional printer gets its own port (7126, 7127, …).
+- **Switch printers:** use the dropdown in the header (next to the printer
+  name), or open the **Printers** tab and click **"Switch"**
+  on any non-active printer's card. Each card also shows live status
+  (state, current file, progress bar, nozzle/bed temperature) fetched
+  directly from that printer's own bridge instance.
+- **Remove a printer:** click the **✕** button on its card in the
+  **Printers** tab; you'll be asked to confirm.
+
+---
+
+## Power Switch Feature
+
+The power switch feature lets the bridge turn an external **smart plug**
+on or off, and query its state — it is **not** a connection to the
+printer's own internal power management, since the printer has no
+remotely controllable power state of its own. You need a smart plug
+(commonly a Tasmota-flashed plug) wired between the wall outlet and the
+printer's power supply, reachable over HTTP from the bridge.
+
+Configure it under **Settings → Connection**, in the "Power Switch" card,
+with three
+URLs:
+
+- **Power-On URL** — called to switch the plug on.
+- **Power-Off URL** — called to switch the plug off.
+- **Status URL** — polled to show the current on/off state.
+
+For a Tasmota device, these are typically of the form:
+
+```
+http://192.168.x.x/cm?cmnd=Power%20on
+http://192.168.x.x/cm?cmnd=Power%20off
+http://192.168.x.x/cm?cmnd=Power
+```
+
+replacing `192.168.x.x` with the smart plug's own IP address (not the
+printer's). Once configured, a 🔌 power icon appears next to that
+printer's card in the **Printers** tab; click it to toggle the plug.
+Turning it off asks for confirmation, since it will cut power to whatever
+is plugged in — make sure nothing is printing first. The icon's color
+reflects the last known state (green = on, gray = off) as reported by the
+status URL.
+
+---
+
+## Settings Reference
+
+Settings are organized into tabs on the **Settings** panel:
+
+- **Connection** — printer name, printer IP, MQTT port,
+  MQTT username/password, device ID and mode ID (normally filled in
+  automatically by "Add printer"), plus the Power Switch URLs described
+  above.
+- **Printer** — default slot for single-color prints,
+  auto-leveling and resonance-compensation defaults, upload/print-start
+  behavior, camera auto-start, and the web-upload confirmation warning
+  (see [Printing](#printing)).
+- **Display** — UI language (DE/EN/ES/FR/IT/中文), light/dark
+  theme toggle, how often the bridge polls the printer for status updates,
+  and a verbose HTTP request logging toggle for troubleshooting.
+- **Filament** — OrcaSlicer profile import, per-slot profile mapping,
+  visible-vendor filtering, and (if Spoolman is connected) the Spoolman
+  slot-assignment panel — all described in
+  [Managing Filaments](#managing-filaments).
+- **Integrations** — Spoolman server URL and sync rate, and
+  an info box pointing to the `moonraker-obico.cfg` file used to configure
+  Obico (Obico itself is set up outside the bridge UI — see
+  [Camera / OrcaSlicer-KX / Obico](#camera--orcaslicer-kx--obico) below).
+- **System** — shows the current bridge version and lets you check for and
+  install updates directly from the browser, including a changelog preview.
+
+Most settings changes are applied via the **Save &
+Restart** button at the bottom of the Settings panel, which restarts the
+bridge process to apply them.
+
+---
+
+## Troubleshooting Basics
+
+- **Logs:** the **Console** tab shows a live event log with
+  filters by direction (RX/TX), level (errors/warnings), and topic (AMS,
+  print, info, status), plus a free-text filter and a download button for
+  the full log file.
+- **"Wrong MQTT credentials" on start:** re-add the printer via
+  "+ Add printer", or see the credential-refresh steps in the README's
+  [Troubleshooting](README.md#-troubleshooting) section.
+- **Printer not found / no LAN mode:** confirm LAN mode is enabled on the
+  printer's display and that the printer and bridge are on the same
+  network.
+- **Docker permission errors, upgrading from old versions, and other
+  install-level issues:** see the README's own
+  [Troubleshooting](README.md#-troubleshooting) section.
+
+For anything not covered here or in the README, please check or open an
+issue on the project's Gitea page:
+<https://gitea.it-drui.de/viewit/KX-Bridge-Release/issues>.
+
+---
+
+## Camera / OrcaSlicer-KX / Obico
+
+- **Camera:** the Dashboard's Camera tile plays the printer's live stream
+  directly; no separate setup is required beyond having the printer
+  connected.
+- **OrcaSlicer-KX:** for filament brand/color to sync correctly into
+  OrcaSlicer's AMS view, use the patched community build — see the
+  README's [Recommended Slicer](README.md#-recommended-slicer) section for
+  the download link and what it changes.
+- **Obico:** self-hosted failure-detection and time-lapse integration runs
+  through the separate `moonraker-obico` plugin/container, configured via
+  the config file referenced under **Settings → Integrations → Obico**.
+  Full setup instructions live in the README's
+  [Community & Integrations](README.md#-community--integrations) section.

NIGHTLY_CHANGELOG.md

@@ -0,0 +1,2 @@
+## Changes in this build
+

README.de.md

@@ -23,15 +23,13 @@ Feedback willkommen.</sub>
 &nbsp;
 [![Downloads](https://img.shields.io/badge/Downloads-3.1k%2B-8957E5?style=for-the-badge&logo=gitea&logoColor=white)](https://gitea.it-drui.de/viewit/KX-Bridge-Release/releases)
 &nbsp;
-[![Video](https://img.shields.io/badge/YouTube-Tutorial-FF0000?style=for-the-badge&logo=youtube&logoColor=white)](https://www.youtube.com/watch?v=1Ql4wfH27fM)
+[![Video](https://img.shields.io/badge/YouTube-Tutorial-FF0000?style=for-the-badge&logo=youtube&logoColor=white)](https://www.youtube.com/watch?v=E3sDigSeSdM)
 
 <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>
 
-> [!CAUTION]
-> **Laufende Wartungsarbeiten** — Wir strukturieren das Repository um (Branch-Modell, CI-Workflows, Beitragsprozess). Es kann zu Änderungen bei Branch-Namen, PR-Templates und der Art der Veröffentlichungen kommen. Wir entschuldigen uns für etwaige Unannehmlichkeiten. Handhabung, Workflow und langfristige Wartbarkeit werden dadurch deutlich verbessert.
->
+
 > 👉 Möchtest du beitragen? Bitte zuerst [CONTRIBUTING.md](CONTRIBUTING.md) lesen.
 
 ---
@@ -43,12 +41,16 @@ Feedback willkommen.</sub>
 | 🖨️ | **Druckersteuerung** — Start, Pause, Resume, Abbruch, Temperaturen, Druckgeschwindigkeit |
 | 📊 | **Live-Status** — Temperatur, Fortschritt, Layer, Restzeit, Kamera-Stream |
 | 🎨 | **AMS / Multicolor** — Slots mit **Profil-Picker pro Slot** (eigene Marke aus OrcaSlicer-Profilen pro Slot zuweisen); Bridge schreibt Material und Farbe ans Drucker-Display zurück |
+| 🏷️ | **Custom-RFID-Tag-Matching** — mit Drittanbieter-Tools (z.B. der „ACE RFID"-App) beschriebene Spulen werden automatisch nach Marke + Material gegen deine importierten OrcaSlicer-Profile gematcht, statt auf ein generisches Profil zurückzufallen |
 | 📦 | **Eigene OrcaSlicer-Profile importieren** — ZIP aus `~/.config/OrcaSlicer/user/<id>/filament/` in die Bridge ziehen; tauchen im Slot-Dropdown unter ★ Eigene Profile auf |
+| 🧵 | **Spoolman-Integration** — Spulen einzelnen AMS-Slots zuweisen, Filament-Verbrauch wird automatisch beim Drucken erfasst und synchronisiert |
+| 🔗 | **Multi-ACE-Unterstützung** — mehrere aneinandergekettete ACE-Einheiten, auch bei Druckern ohne Toolhead-Buffer |
 | 📷 | **Obico-Integration (experimentell)** — Time-Lapse und WebRTC-Livestream gegen einen selbst gehosteten [Obico-Server](https://github.com/TheSpaghettiDetective/obico-server) via moonraker-obico |
-| 📐 | **H.264-Direkt-Stream + Z-Höhe** — sparsamer Kamera-Pfad für Obico, aktuelle Z aus der Layer-Höhe abgeleitet (Mm-Progress-Widget) |
-| 🗂️ | **GCode-Browser** — hochgeladene Dateien mit Thumbnail, Druckhistorie, Suche & Filter |
+| 📐 | **H.264-Direkt-Stream + Z-Höhe** — sparsamer Kamera-Pfad für Obico, aktuelle Z aus der Layer-Höhe abgeleitet (Mm-Progress-Widget); erholt sich automatisch nach einem Drucker-Reboot mit rotiertem Stream-Token, kein manueller Reset nötig |
+| 🗂️ | **GCode-Browser** — zwei Tabs: hochgeladene Dateien (mit Thumbnail, Druckhistorie, Suche & Filter, Mehrfachauswahl + Sammel-Löschen) und Dateien direkt auf dem Drucker-Speicher (mit echten Thumbnails, Mehrfachauswahl + Löschen) |
 | 🧩 | **Multi-Printer** — mehrere Drucker in **einer** Bridge-Instanz, Umschalten per Dropdown |
 | ➕ | **Drucker hinzufügen per Klick** — nur die IP eingeben, Zugangsdaten werden automatisch importiert |
+| 🖱️ | **Frei anpassbares Dashboard** — Kacheln per Drag & Drop verschieben und in der Größe anpassen, als Preset speichern |
 | 🔁 | **Robuster MQTT-Reconnect** — Bridge überlebt nächtlichen Drucker-Reboot ohne manuellen Neustart |
 | 🌐 | **Mehrsprachiges UI** — DE / EN / ES / FR / IT / 中文, Browser-Sprache automatisch erkannt |
 | 🔄 | **Self-Update** — neue Versionen direkt im Browser installieren |
@@ -70,6 +72,11 @@ LAN-Modus am Kobra X aktivieren:
 docker compose up -d
 ```
 
+> Zusätzlich Spoolman und einen kompletten selbst gehosteten Obico-Setup
+> (Spaghetti-Erkennung, Live-Stream) neben der Bridge? [`docker-compose-KX.yml`](docker-compose-KX.yml)
+> bündelt KX-Bridge + Spoolman + Obico (Web/ML/Tasks/Redis) + moonraker-obico
+> in einem Netzwerk — Setup-Schritte in den Kommentaren am Dateianfang.
+
 **Linux-Binary (kein Docker):**
 ```bash
 chmod +x kx-bridge && ./kx-bridge
@@ -112,7 +119,7 @@ Drucker → Verbindungstyp **Moonraker** → Host: `http://BRIDGE-IP:7125`
 
 ## 📺 Video-Tutorial
 
-[![KX-Bridge Setup & Usage](https://img.youtube.com/vi/1Ql4wfH27fM/hqdefault.jpg)](https://www.youtube.com/watch?v=1Ql4wfH27fM)
+[![KX-Bridge Setup & Usage](https://img.youtube.com/vi/E3sDigSeSdM/hqdefault.jpg)](https://www.youtube.com/watch?v=E3sDigSeSdM)
 
 ---
 

README.es.md

@@ -22,7 +22,7 @@ ninguna está oficialmente probada ni soportada. Se agradece el feedback.</sub>
 &nbsp;
 [![Downloads](https://img.shields.io/badge/Descargas-3.1k%2B-8957E5?style=for-the-badge&logo=gitea&logoColor=white)](https://gitea.it-drui.de/viewit/KX-Bridge-Release/releases)
 &nbsp;
-[![Video](https://img.shields.io/badge/YouTube-Tutorial-FF0000?style=for-the-badge&logo=youtube&logoColor=white)](https://www.youtube.com/watch?v=1Ql4wfH27fM)
+[![Video](https://img.shields.io/badge/YouTube-Tutorial-FF0000?style=for-the-badge&logo=youtube&logoColor=white)](https://www.youtube.com/watch?v=E3sDigSeSdM)
 
 <sub>¿Te gusta KX-Bridge? Un café en <a href="https://ko-fi.com/viewitde">Ko-fi</a> mantiene el proyecto vivo. ☕</sub>
 
@@ -42,12 +42,16 @@ ninguna está oficialmente probada ni soportada. Se agradece el feedback.</sub>
 | 🖨️ | **Control de impresora** — iniciar, pausar, reanudar, cancelar, temperaturas, velocidad de impresión |
 | 📊 | **Estado en tiempo real** — temperatura, progreso, capas, tiempo restante, transmisión de cámara |
 | 🎨 | **AMS / multicolor** — ranuras con **selector de perfil por ranura** (asigna tu propia marca de los perfiles de OrcaSlicer a cada ranura); el puente escribe material y color al display de la impresora |
+| 🏷️ | **Coincidencia de etiquetas RFID personalizadas** — las bobinas etiquetadas con herramientas de terceros (p. ej. la app "ACE RFID") se emparejan automáticamente por marca + material con tus perfiles de OrcaSlicer importados, en lugar de caer en un perfil genérico |
 | 📦 | **Importa tus propios perfiles de OrcaSlicer** — arrastra un ZIP de `~/.config/OrcaSlicer/user/<id>/filament/` al puente; aparecen en el desplegable de la ranura bajo ★ Perfiles propios |
+| 🧵 | **Integración con Spoolman** — asigna bobinas a las ranuras del AMS, el consumo de filamento se registra y sincroniza automáticamente al imprimir |
+| 🔗 | **Soporte multi-ACE** — múltiples unidades ACE encadenadas, incluso en impresoras sin buffer en el cabezal |
 | 📷 | **Integración con Obico (experimental)** — Time-Lapse y stream en vivo WebRTC contra un [servidor Obico](https://github.com/TheSpaghettiDetective/obico-server) autoalojado vía moonraker-obico |
-| 📐 | **Stream H.264 directo + altura Z** — ruta de cámara de bajo consumo de CPU para Obico, Z actual derivada de la altura de capa (widget de progreso) |
-| 🗂️ | **Explorador de GCode** — archivos subidos con vistas previas, historial de impresión, búsqueda y filtros |
+| 📐 | **Stream H.264 directo + altura Z** — ruta de cámara de bajo consumo de CPU para Obico, Z actual derivada de la altura de capa (widget de progreso); se recupera automáticamente tras un reinicio de la impresora que rota el token del stream, sin necesidad de reinicio manual |
+| 🗂️ | **Explorador de GCode** — dos pestañas: archivos subidos (con vistas previas, historial de impresión, búsqueda y filtros, selección múltiple + borrado masivo) y archivos almacenados directamente en la memoria de la impresora (con vistas previas reales, selección múltiple + borrado) |
 | 🧩 | **Multi-impresora** — múltiples impresoras en **una** instancia del puente, cambia mediante un menú desplegable |
 | ➕ | **Añade una impresora con un clic** — solo introduce la IP, las credenciales se importan automáticamente |
+| 🖱️ | **Panel de control libre** — arrastra y redimensiona las tarjetas del panel a tu gusto, guárdalo como preset |
 | 🔁 | **Reconexión MQTT robusta** — el puente sobrevive a reinicios nocturnos de la impresora sin reinicio manual |
 | 🌐 | **Interfaz multilingüe** — DE / EN / ES / FR / IT / 中文, detecta automáticamente el idioma del navegador |
 | 🔄 | **Actualización automática** — instala nuevas versiones directamente desde el navegador |
@@ -69,6 +73,11 @@ Activa el modo LAN en la Kobra X:
 docker compose up -d
 ```
 
+> ¿Quieres Spoolman y un setup completo de Obico autoalojado (detección de
+> espagueti, stream en vivo) junto al puente? [`docker-compose-KX.yml`](docker-compose-KX.yml)
+> combina KX-Bridge + Spoolman + Obico (web/ML/tasks/redis) + moonraker-obico
+> en una sola red — consulta los comentarios al inicio del archivo para los pasos de configuración.
+
 **Binario Linux (sin Docker):**
 ```bash
 chmod +x kx-bridge && ./kx-bridge
@@ -111,7 +120,7 @@ Impresora → Tipo de conexión **Moonraker** → Host: `http://IP-DEL-PUENTE:71
 
 ## 📺 Vídeo tutorial
 
-[![Configuración y uso de KX-Bridge](https://img.youtube.com/vi/1Ql4wfH27fM/hqdefault.jpg)](https://www.youtube.com/watch?v=1Ql4wfH27fM)
+[![Configuración y uso de KX-Bridge](https://img.youtube.com/vi/E3sDigSeSdM/hqdefault.jpg)](https://www.youtube.com/watch?v=E3sDigSeSdM)
 
 ---
 

README.md

@@ -22,7 +22,7 @@ officially tested or supported. Feedback welcome.</sub>
 &nbsp;
 [![Downloads](https://img.shields.io/badge/Downloads-3.1k%2B-8957E5?style=for-the-badge&logo=gitea&logoColor=white)](https://gitea.it-drui.de/viewit/KX-Bridge-Release/releases)
 &nbsp;
-[![Video](https://img.shields.io/badge/YouTube-Tutorial-FF0000?style=for-the-badge&logo=youtube&logoColor=white)](https://www.youtube.com/watch?v=1Ql4wfH27fM)
+[![Video](https://img.shields.io/badge/YouTube-Tutorial-FF0000?style=for-the-badge&logo=youtube&logoColor=white)](https://www.youtube.com/watch?v=E3sDigSeSdM)
 
 <sub>Like KX-Bridge? A coffee on <a href="https://ko-fi.com/viewitde">Ko-fi</a> keeps the project alive. ☕</sub>
 
@@ -33,6 +33,8 @@ officially tested or supported. Feedback welcome.</sub>
 >
 > 👉 Want to contribute? Please read [CONTRIBUTING.md](CONTRIBUTING.md) first.
 
+> 📖 Looking for day-to-day usage help? See the [User Manual](MANUAL.md). Building an integration? See the [API Reference](API.md).
+
 ---
 
 ## ✨ Features
@@ -42,12 +44,16 @@ officially tested or supported. Feedback welcome.</sub>
 | 🖨️ | **Printer control** — start, pause, resume, cancel, temperatures, print speed |
 | 📊 | **Live status** — temperature, progress, layers, remaining time, camera stream |
 | 🎨 | **AMS / multicolor** — slots with per-slot **profile picker** (assign your own brand from OrcaSlicer profiles per slot); bridge writes material & colour back to the printer display |
+| 🏷️ | **Custom RFID tag matching** — spools tagged with third-party tools (e.g. the "ACE RFID" app) auto-match vendor + material against your imported OrcaSlicer profiles instead of falling back to a generic default |
 | 📦 | **Import your own OrcaSlicer profiles** — drag a ZIP from `~/.config/OrcaSlicer/user/<id>/filament/` into the bridge; they show up in the slot dropdown under ★ Own profiles |
+| 🧵 | **Spoolman integration** — assign spools to AMS slots, filament usage tracked and synced automatically as you print |
+| 🔗 | **Multi-ACE support** — multiple daisy-chained ACE units, including printers without a toolhead buffer |
 | 📷 | **Obico integration (experimental)** — Time-Lapse and WebRTC live stream against a self-hosted [Obico server](https://github.com/TheSpaghettiDetective/obico-server) via moonraker-obico |
-| 📐 | **Direct H.264 stream + Z-height** — low-CPU camera path for Obico, current Z derived from layer-height for the print-progress widget |
-| 🗂️ | **GCode browser** — uploaded files with thumbnails, print history, search & filter |
+| 📐 | **Direct H.264 stream + Z-height** — low-CPU camera path for Obico, current Z derived from layer-height for the print-progress widget; auto-recovers after a printer reboot rotates its stream token, no manual reset needed |
+| 🗂️ | **GCode browser** — two tabs: files you've uploaded (with thumbnails, print history, search & filter, multi-select + bulk delete) and files stored directly on the printer's own storage (with real thumbnails, multi-select + delete) |
 | 🧩 | **Multi-printer** — multiple printers in **one** bridge instance, switch via dropdown |
 | ➕ | **Add a printer with one click** — just enter the IP, credentials are imported automatically |
+| 🖱️ | **Free-form dashboard** — drag & resize the dashboard tiles into your own layout, save it as a preset |
 | 🔁 | **Robust MQTT reconnect** — bridge survives overnight printer reboots without manual restart |
 | 🌐 | **Multi-language UI** — DE / EN / ES / FR / IT / 中文, auto-detect browser locale |
 | 🔄 | **Self-update** — install new versions directly in the browser |
@@ -69,6 +75,11 @@ Enable LAN mode on the Kobra X:
 docker compose up -d
 ```
 
+> Want Spoolman and a full self-hosted Obico setup (spaghetti detection, live stream)
+> alongside the bridge? [`docker-compose-KX.yml`](docker-compose-KX.yml) bundles
+> KX-Bridge + Spoolman + Obico (web/ML/tasks/redis) + moonraker-obico behind one
+> network — see the file's header comments for setup steps.
+
 **Linux binary (no Docker):**
 ```bash
 chmod +x kx-bridge && ./kx-bridge
@@ -111,7 +122,7 @@ Printer → Connection type **Moonraker** → Host: `http://BRIDGE-IP:7125`
 
 ## 📺 Video Tutorial
 
-[![KX-Bridge Setup & Usage](https://img.youtube.com/vi/1Ql4wfH27fM/hqdefault.jpg)](https://www.youtube.com/watch?v=1Ql4wfH27fM)
+[![KX-Bridge Setup & Usage](https://img.youtube.com/vi/E3sDigSeSdM/hqdefault.jpg)](https://www.youtube.com/watch?v=E3sDigSeSdM)
 
 ---
 

config.ini.example

@@ -41,6 +41,21 @@ web_upload_warning = 1
 # Poll-Intervall in Sekunden
 poll_interval    = 3
 
+# ─── Spoolman (optional) ───────────────────────────────────────────────────────
+# Verfolgt den Filamentverbrauch je AMS-Slot und bucht ihn automatisch vom
+# passenden Spool ab (mm-basiert, wie Moonraker; Spoolman rechnet mm→Gramm).
+# [spoolman]
+# # Server-URL der Spoolman-Instanz (aus Sicht des Bridge-Containers erreichbar):
+# server    = http://192.168.x.x:7912
+# # 0 = nur am Druckende abbuchen, >0 = alle N Sekunden während des Drucks:
+# sync_rate = 0
+#
+# Die AMS-Slot → Spool-Zuordnung wird in der Weboberfläche gesetzt und je Drucker
+# automatisch persistiert (nicht von Hand eintragen):
+#   Einzeldrucker : [spoolman]   slot_spools = 0:42,1:17
+#   Multi-Printer : [spoolman_1] slot_spools = 0:42,1:17
+#                   [spoolman_2] slot_spools = 0:5,1:6
+
 # ─── Multi-Printer (optional) ──────────────────────────────────────────────────
 # Mehrere Drucker können als [printer_1], [printer_2], … definiert werden.
 # Jede Bridge-Instanz verbindet sich mit einem Drucker (je eigener Port).

config_loader.py

@@ -1,12 +1,16 @@
 """
-config_loader.py – lädt Verbindungsparameter aus config/config.ini (primär)
-oder .env (Fallback / Migration).
-Umgebungsvariablen haben immer Vorrang.
+config_loader.py - loads connection parameters from config/config.ini (primary)
+or .env (fallback / migration).
+Environment variables always take precedence.
 """
 import os
 import sys
 import pathlib
 import configparser
+import logging
+from typing import Optional
+
+log = logging.getLogger("kobrax.config")
 
 _BASE = pathlib.Path(sys.executable).parent if getattr(sys, "frozen", False) else pathlib.Path(__file__).parent
 
@@ -33,7 +37,7 @@ def _find_env_file() -> pathlib.Path | None:
 
 
 def _load_env_file(path: pathlib.Path):
-    """Lädt .env-Datei als Fallback – setzt nur Keys die noch nicht in os.environ sind."""
+    """Loads the .env file as a fallback - only sets keys not yet in os.environ."""
     with open(path, encoding="utf-8") as f:
         for line in f:
             line = line.strip()
@@ -46,28 +50,43 @@ def _load_env_file(path: pathlib.Path):
                 os.environ[key] = val
 
 
+# Single source of truth for env-var <-> config.ini mapping. _restart_bridge()
+# in kobrax_moonraker_bridge.py clears exactly these keys from os.environ
+# before restarting, so a value removed here or in the UI settings save can
+# never survive as a stale env var read by the new process. Add new settings
+# here ONLY - no second list to keep in sync.
+CONFIG_ENV_MAPPING = {
+    "PRINTER_IP":       (CONFIG_SECTION_CONNECTION, "printer_ip"),
+    "MQTT_PORT":        (CONFIG_SECTION_CONNECTION, "mqtt_port"),
+    "MQTT_USERNAME":    (CONFIG_SECTION_CONNECTION, "username"),
+    "MQTT_PASSWORD":    (CONFIG_SECTION_CONNECTION, "password"),
+    "MODE_ID":          (CONFIG_SECTION_CONNECTION, "mode_id"),
+    "DEVICE_ID":        (CONFIG_SECTION_CONNECTION, "device_id"),
+    "POWER_ON_URL":     (CONFIG_SECTION_CONNECTION, "power_on_url"),
+    "POWER_OFF_URL":    (CONFIG_SECTION_CONNECTION, "power_off_url"),
+    "POWER_STATUS_URL": (CONFIG_SECTION_CONNECTION, "power_status_url"),
+    "DEFAULT_AMS_SLOT":     (CONFIG_SECTION_PRINT,   "default_ams_slot"),
+    "AUTO_LEVELING":            (CONFIG_SECTION_PRINT,   "auto_leveling"),
+    "VIBRATION_COMPENSATION":   (CONFIG_SECTION_PRINT,   "vibration_compensation"),
+    "CAMERA_ON_PRINT":          (CONFIG_SECTION_PRINT,   "camera_on_print"),
+    "WEB_UPLOAD_WARNING":   (CONFIG_SECTION_PRINT,   "web_upload_warning"),
+    "DELETE_PRINTER_FILE_AFTER_PRINT": (CONFIG_SECTION_PRINT, "delete_printer_file_after_print"),
+    "PRINT_START_DIALOG":   (CONFIG_SECTION_PRINT,   "print_start_dialog"),
+    "BRIDGE_PRINTER_NAME":  (CONFIG_SECTION_BRIDGE,  "printer_name"),
+    "BRIDGE_HOST_IP":       (CONFIG_SECTION_BRIDGE,  "host_ip"),
+    "POLL_INTERVAL":        (CONFIG_SECTION_BRIDGE,  "poll_interval"),
+    "VERBOSE_HTTP_LOG":     (CONFIG_SECTION_BRIDGE,  "verbose_http_log"),
+    "SPOOLMAN_SERVER":      (CONFIG_SECTION_SPOOLMAN, "server"),
+    "SPOOLMAN_SYNC_RATE":   (CONFIG_SECTION_SPOOLMAN, "sync_rate"),
+}
+
+
 def _load_config_file(path: pathlib.Path):
-    """Lädt config.ini und setzt Keys in os.environ (nur wenn nicht bereits gesetzt)."""
-    cfg = configparser.ConfigParser()
+    """Loads config.ini and sets keys in os.environ (only if not already set)."""
+    cfg = configparser.ConfigParser(interpolation=None)
     cfg.read(path, encoding="utf-8")
 
-    mapping = {
-        "PRINTER_IP":       (CONFIG_SECTION_CONNECTION, "printer_ip"),
-        "MQTT_PORT":        (CONFIG_SECTION_CONNECTION, "mqtt_port"),
-        "MQTT_USERNAME":    (CONFIG_SECTION_CONNECTION, "username"),
-        "MQTT_PASSWORD":    (CONFIG_SECTION_CONNECTION, "password"),
-        "MODE_ID":          (CONFIG_SECTION_CONNECTION, "mode_id"),
-        "DEVICE_ID":        (CONFIG_SECTION_CONNECTION, "device_id"),
-        "DEFAULT_AMS_SLOT":     (CONFIG_SECTION_PRINT,   "default_ams_slot"),
-        "AUTO_LEVELING":        (CONFIG_SECTION_PRINT,   "auto_leveling"),
-        "CAMERA_ON_PRINT":      (CONFIG_SECTION_PRINT,   "camera_on_print"),
-        "WEB_UPLOAD_WARNING":   (CONFIG_SECTION_PRINT,   "web_upload_warning"),
-        "PRINT_START_DIALOG":   (CONFIG_SECTION_PRINT,   "print_start_dialog"),
-        "BRIDGE_PRINTER_NAME":  (CONFIG_SECTION_BRIDGE,  "printer_name"),
-        "SPOOLMAN_SERVER":      (CONFIG_SECTION_SPOOLMAN, "server"),
-        "SPOOLMAN_SYNC_RATE":   (CONFIG_SECTION_SPOOLMAN, "sync_rate"),
-    }
-    for env_key, (section, option) in mapping.items():
+    for env_key, (section, option) in CONFIG_ENV_MAPPING.items():
         if env_key not in os.environ:
             try:
                 val = cfg.get(section, option)
@@ -100,8 +119,7 @@ def migrate_env_to_config(env_path: pathlib.Path, config_path: pathlib.Path):
             k, _, v = line.partition("=")
             env_vals[k.strip()] = v.strip()
 
-    config_path.parent.mkdir(parents=True, exist_ok=True)
-    cfg = configparser.ConfigParser()
+    cfg = configparser.ConfigParser(interpolation=None)
     cfg[CONFIG_SECTION_CONNECTION] = {
         "printer_ip": env_vals.get("PRINTER_IP", ""),
         "mqtt_port":  env_vals.get("MQTT_PORT",  "9883"),
@@ -112,21 +130,32 @@ def migrate_env_to_config(env_path: pathlib.Path, config_path: pathlib.Path):
     }
     cfg[CONFIG_SECTION_PRINT] = {
         "default_ams_slot": env_vals.get("DEFAULT_AMS_SLOT", "auto"),
-        "auto_leveling":    env_vals.get("AUTO_LEVELING",    "1"),
-        "camera_on_print":  env_vals.get("CAMERA_ON_PRINT",  "0"),
+        "auto_leveling":          env_vals.get("AUTO_LEVELING",           "1"),
+        "vibration_compensation": env_vals.get("VIBRATION_COMPENSATION",  "0"),
+        "camera_on_print":        env_vals.get("CAMERA_ON_PRINT",         "0"),
         "web_upload_warning": env_vals.get("WEB_UPLOAD_WARNING", "1"),
     }
     cfg[CONFIG_SECTION_BRIDGE] = {
         "poll_interval": "3",
     }
-    with open(config_path, "w", encoding="utf-8") as f:
-        f.write("# KX-Bridge Konfigurationsdatei\n")
-        f.write("# Automatisch migriert aus .env\n\n")
-        cfg.write(f)
+    # This runs at module import time (see the "Laden" section below) - an
+    # uncaught mkdir/write failure (e.g. a read-only filesystem) would crash
+    # the whole bridge at startup with a raw traceback. Log a clear diagnostic
+    # before re-raising, so the actual cause (permissions, disk full) is
+    # visible instead of a bare stack trace pointing into configparser.
+    try:
+        config_path.parent.mkdir(parents=True, exist_ok=True)
+        with open(config_path, "w", encoding="utf-8") as f:
+            f.write("# KX-Bridge Konfigurationsdatei\n")
+            f.write("# Automatically migrated from .env\n\n")
+            cfg.write(f)
+    except OSError as e:
+        log.error("Failed to write migrated config.ini to %s: %s", config_path, e)
+        raise
 
 
 def find_config_path() -> pathlib.Path:
-    """Gibt den Pfad zur config.ini zurück (auch wenn sie noch nicht existiert)."""
+    """Returns the path to config.ini (even if it does not exist yet)."""
     for base in (_BASE, _BASE.parent):
         config_dir = base / "config"
         if config_dir.is_dir():
@@ -142,7 +171,7 @@ _env_path    = _find_env_file()
 if _config_path:
     _load_config_file(_config_path)
 elif _env_path:
-    # Kein config.ini vorhanden → aus .env migrieren
+    # No config.ini present -> migrate from .env
     _target = find_config_path()
     migrate_env_to_config(_env_path, _target)
     _load_config_file(_target)
@@ -150,19 +179,19 @@ elif _env_path:
 
 
 def list_printers() -> list[dict]:
-    """Liest alle [printer_N]-Sektionen aus config.ini.
+    """Reads all [printer_N] sections from config.ini.
 
-    Jede Sektion kann folgende Keys haben:
+    Each section may contain the following keys:
       name, printer_ip, mqtt_port, username, password, mode_id, device_id,
       bridge_url, default_ams_slot, auto_leveling
 
-    Gibt eine leere Liste zurück wenn keine [printer_N]-Sektionen vorhanden sind
+    Returns an empty list when no [printer_N] sections exist
     (Single-Printer-Betrieb via [connection]).
     """
     path = _find_config_file()
     if not path:
         return []
-    cfg = configparser.ConfigParser()
+    cfg = configparser.ConfigParser(interpolation=None)
     cfg.read(path, encoding="utf-8")
     printers: list[dict] = []
     idx = 1
@@ -182,37 +211,58 @@ def list_printers() -> list[dict]:
     return printers
 
 
-def list_filament_profiles() -> dict[int, dict]:
-    """Liest die [filament_profiles]-Sektion aus config.ini.
+def _filament_section(printer_id: Optional[str] = None) -> str:
+    """Section name holding a printer's filament-profile mapping.
 
-    Format pro AMS-Slot — primärer Selector ist (vendor, name), die `id` wird
-    aus der orca_filaments.json beim Speichern nachgeschlagen und mitgeführt
-    (als Hint für OrcaSlicer; das Orca-Datenmodell hat ~136 Profile mit
-    derselben filament_id wie 'OGFL99', d.h. die ID ist nicht eindeutig):
+    Multi-printer (one bridge, N printers): each printer keeps its own
+    ``[filament_profiles_<id>]`` section so the mappings cannot overwrite each
+    other. ``printer_id is None`` (single-printer / legacy callers) maps to the
+    original global ``[filament_profiles]`` section — full backward compatibility.
+    """
+    pid = str(printer_id).strip() if printer_id is not None else ""
+    if pid and pid != "0":
+        return f"filament_profiles_{pid}"
+    return "filament_profiles"
+
+
+def list_filament_profiles(printer_id: Optional[str] = None) -> dict[int, dict]:
+    """Reads the [filament_profiles] section from config.ini.
+
+    With ``printer_id`` set, reads the per-printer ``[filament_profiles_<id>]``
+    section and falls back to the legacy global ``[filament_profiles]`` while
+    that printer has no own section yet.
+
+    Format per AMS slot - the primary selector is (vendor, name); the `id` is
+    looked up from orca_filaments.json on save and carried along
+    (as a hint for OrcaSlicer; the Orca data model has ~136 profiles sharing
+    the same filament_id like 'OGFL99', i.e. the ID is not unique):
 
       [filament_profiles]
       slot_0_vendor = Polymaker
       slot_0_name   = PolyTerra PLA
       slot_0_id     = OGFL01
 
-    Gibt einen Dict {slot_index: {"id": ..., "vendor": ..., "name": ...}}
-    zurück. Leere/fehlende Slots werden NICHT aufgenommen — das Default-Mapping
-    (per filament_type) in der Bridge bleibt dann aktiv.
+    Returns a dict {slot_index: {"id": ..., "vendor": ..., "name": ...}}.
+    Empty/missing slots are NOT included - the default mapping
+    (per filament_type) in the bridge then stays active.
 
-    Backwards-Kompat: alte Configs mit nur (vendor, id) bleiben lesbar; `name`
-    fehlt dann und der Aufrufer kann optional aus der orca_filaments.json
+    Backwards compat: old configs with only (vendor, id) stay readable; `name`
+    is then missing and the caller can optionally resolve it from orca_filaments.json
     rekonstruieren.
     """
     path = _find_config_file()
     if not path:
         return {}
-    cfg = configparser.ConfigParser()
+    cfg = configparser.ConfigParser(interpolation=None)
     cfg.read(path, encoding="utf-8")
-    if not cfg.has_section("filament_profiles"):
+    section = _filament_section(printer_id)
+    if not cfg.has_section(section):
+        section = "filament_profiles"          # fallback: legacy global section
+    if not cfg.has_section(section):
         return {}
     result: dict[int, dict] = {}
-    for key, value in cfg.items("filament_profiles"):
-        # Erwartet: slot_<idx>_id oder slot_<idx>_vendor oder slot_<idx>_name
+    for key, value in cfg.items(section):
+        # Expects: slot_<idx>_id or slot_<idx>_vendor or slot_<idx>_name
         if not key.startswith("slot_"):
             continue
         parts = key.split("_", 2)
@@ -231,74 +281,173 @@ def list_filament_profiles() -> dict[int, dict]:
     return result
 
 
-def save_filament_profiles(profiles: dict[int, dict]) -> bool:
-    """Schreibt die übergebenen Slot-Profile in die [filament_profiles]-
-    Sektion der config.ini. Existierende Einträge werden komplett ersetzt.
+def save_filament_profiles(profiles: dict[int, dict], printer_id: Optional[str] = None) -> bool:
+    """Writes the given slot profiles into the [filament_profiles]
+    section of config.ini. Existing entries are completely replaced.
 
     profiles: {slot_index: {"id": "OGFL01", "vendor": "Polymaker", "name": "PolyTerra PLA"}}
-    Mindestens vendor+name müssen gesetzt sein; id ist optional (Hint).
+    At least vendor+name must be set; id is optional (hint).
+
+    With ``printer_id`` set, writes the per-printer ``[filament_profiles_<id>]``
+    section only — other printers and the legacy global section are untouched.
     """
     path = _find_config_file()
     if not path:
         return False
-    cfg = configparser.ConfigParser()
+    cfg = configparser.ConfigParser(interpolation=None)
     cfg.read(path, encoding="utf-8")
-    # visible_vendors (Issue #41) ist kein Slot-Mapping — beim Ersetzen der
-    # Sektion erhalten, sonst geht der Vendor-Filter beim Slot-Save verloren.
+    section = _filament_section(printer_id)
+    # visible_vendors (Issue #41) is not a slot mapping - preserve it when
+    # replacing the section, otherwise the vendor filter is lost on slot save.
+    # First save of a per-printer section inherits the legacy global filter.
     preserved_vendors = None
-    if cfg.has_option("filament_profiles", "visible_vendors"):
+    if cfg.has_option(section, "visible_vendors"):
+        preserved_vendors = cfg.get(section, "visible_vendors")
+    elif cfg.has_option("filament_profiles", "visible_vendors"):
         preserved_vendors = cfg.get("filament_profiles", "visible_vendors")
-    if cfg.has_section("filament_profiles"):
-        cfg.remove_section("filament_profiles")
+    if cfg.has_section(section):
+        cfg.remove_section(section)
     if profiles or preserved_vendors:
-        cfg["filament_profiles"] = {}
+        cfg[section] = {}
         if preserved_vendors:
-            cfg["filament_profiles"]["visible_vendors"] = preserved_vendors
+            cfg[section]["visible_vendors"] = preserved_vendors
         for slot_idx in sorted(profiles.keys()):
             entry = profiles[slot_idx] or {}
             if entry.get("vendor"):
-                cfg["filament_profiles"][f"slot_{slot_idx}_vendor"] = entry["vendor"]
+                cfg[section][f"slot_{slot_idx}_vendor"] = entry["vendor"]
             if entry.get("name"):
-                cfg["filament_profiles"][f"slot_{slot_idx}_name"] = entry["name"]
+                cfg[section][f"slot_{slot_idx}_name"] = entry["name"]
             if entry.get("id"):
-                cfg["filament_profiles"][f"slot_{slot_idx}_id"] = entry["id"]
+                cfg[section][f"slot_{slot_idx}_id"] = entry["id"]
     with open(path, "w", encoding="utf-8") as f:
         cfg.write(f)
     return True
 
 
-def list_visible_vendors() -> list[str]:
-    """Liest [filament_profiles] visible_vendors (komma-separiert) aus config.ini.
+def list_visible_vendors(printer_id: Optional[str] = None) -> list[str]:
+    """Reads [filament_profiles] visible_vendors (comma-separated) from config.ini.
 
-    Vendor-Sichtbarkeitsfilter für das Slot-Profil-Dropdown (Issue #41 Option A).
-    Leere Liste = keine Einschränkung (rückwärtskompatibel: alle Vendoren).
+    Vendor visibility filter for the slot profile dropdown (Issue #41 option A).
+    Empty list = no restriction (backwards compatible: all vendors).
+
+    With ``printer_id`` set, reads the per-printer section and falls back to the
+    legacy global ``[filament_profiles]`` filter.
     """
     path = _find_config_file()
     if not path:
         return []
-    cfg = configparser.ConfigParser()
+    cfg = configparser.ConfigParser(interpolation=None)
     cfg.read(path, encoding="utf-8")
-    if not cfg.has_option("filament_profiles", "visible_vendors"):
+    section = _filament_section(printer_id)
+    if not cfg.has_option(section, "visible_vendors"):
+        section = "filament_profiles"          # fallback: legacy global section
+    if not cfg.has_option(section, "visible_vendors"):
         return []
-    raw = cfg.get("filament_profiles", "visible_vendors")
+    raw = cfg.get(section, "visible_vendors")
     return [v.strip() for v in raw.split(",") if v.strip()]
 
 
-def save_visible_vendors(vendors: list[str]) -> bool:
-    """Schreibt visible_vendors in [filament_profiles], ohne die Slot-Mappings
-    (slot_N_*) zu verlieren. Leere Liste entfernt den Key wieder."""
+def save_visible_vendors(vendors: list[str], printer_id: Optional[str] = None) -> bool:
+    """Writes visible_vendors into [filament_profiles] without touching the
+    (slot_N_*) zu verlieren. Leere Liste entfernt den Key wieder.
+
+    With ``printer_id`` set, writes the per-printer section. When that section is
+    created here for the first time, the slot mappings are seeded from the legacy
+    global section so they are not orphaned by the read-fallback in
+    ``list_filament_profiles``."""
     path = _find_config_file()
     if not path:
         return False
-    cfg = configparser.ConfigParser()
+    cfg = configparser.ConfigParser(interpolation=None)
     cfg.read(path, encoding="utf-8")
-    if not cfg.has_section("filament_profiles"):
-        cfg.add_section("filament_profiles")
+    section = _filament_section(printer_id)
+    if not cfg.has_section(section):
+        cfg.add_section(section)
+        if section != "filament_profiles" and cfg.has_section("filament_profiles"):
+            for key, value in cfg.items("filament_profiles"):
+                if key.startswith("slot_"):
+                    cfg[section][key] = value
     clean = [v.strip() for v in (vendors or []) if v and v.strip()]
     if clean:
-        cfg["filament_profiles"]["visible_vendors"] = ", ".join(clean)
-    elif cfg.has_option("filament_profiles", "visible_vendors"):
-        cfg.remove_option("filament_profiles", "visible_vendors")
+        cfg[section]["visible_vendors"] = ", ".join(clean)
+    elif cfg.has_option(section, "visible_vendors"):
+        cfg.remove_option(section, "visible_vendors")
+    with open(path, "w", encoding="utf-8") as f:
+        cfg.write(f)
+    return True
+
+
+def _spoolman_map_section(printer_id: Optional[str] = None) -> str:
+    """Section name holding a printer's AMS-slot → Spoolman-spool map.
+
+    Multi-printer (one bridge, N printers): each printer keeps its map in its
+    own ``[spoolman_<id>]`` section so two AMS units cannot overwrite each
+    other's mapping. ``printer_id is None`` (single-printer / legacy callers)
+    uses the original ``[spoolman] slot_spools`` key — full backward
+    compatibility. The global ``[spoolman]`` section keeps ``server`` /
+    ``sync_rate`` regardless.
+    """
+    pid = str(printer_id).strip() if printer_id is not None else ""
+    if pid and pid != "0":
+        return f"{CONFIG_SECTION_SPOOLMAN}_{pid}"
+    return CONFIG_SECTION_SPOOLMAN
+
+
+def _parse_slot_spools(raw: str) -> dict[int, int]:
+    """Parse ``"0:42,1:17"`` → ``{0: 42, 1: 17}`` (positive spool ids only)."""
+    result: dict[int, int] = {}
+    for pair in (raw or "").split(","):
+        pair = pair.strip()
+        if ":" not in pair:
+            continue
+        k, _, v = pair.partition(":")
+        k, v = k.strip(), v.strip()
+        if k.isdigit() and v.lstrip("-").isdigit() and int(v) > 0:
+            result[int(k)] = int(v)
+    return result
+
+
+def list_spool_map(printer_id: Optional[str] = None) -> dict[int, int]:
+    """Read the AMS-slot → Spoolman-spool-id map from config.ini.
+
+    With ``printer_id`` set, reads the per-printer ``[spoolman_<id>]
+    slot_spools`` key and falls back to the legacy global ``[spoolman]
+    slot_spools`` while that printer has no own section yet. Returns
+    ``{slot_index: spool_id}`` (only positive ids).
+    """
+    path = _find_config_file()
+    if not path:
+        return {}
+    cfg = configparser.ConfigParser(interpolation=None)
+    cfg.read(path, encoding="utf-8")
+    section = _spoolman_map_section(printer_id)
+    if cfg.has_option(section, "slot_spools"):
+        return _parse_slot_spools(cfg.get(section, "slot_spools", fallback=""))
+    if cfg.has_option(CONFIG_SECTION_SPOOLMAN, "slot_spools"):   # legacy global fallback
+        return _parse_slot_spools(cfg.get(CONFIG_SECTION_SPOOLMAN, "slot_spools", fallback=""))
+    return {}
+
+
+def save_spool_map(slot_spools: dict[int, int], printer_id: Optional[str] = None) -> bool:
+    """Persist the AMS-slot → Spoolman-spool-id map to config.ini.
+
+    With ``printer_id`` set, writes only the per-printer ``[spoolman_<id>]``
+    section so other printers and the global ``[spoolman]`` server config stay
+    untouched. An empty map clears the key.
+    """
+    path = _find_config_file()
+    if not path:
+        return False
+    cfg = configparser.ConfigParser(interpolation=None)
+    cfg.read(path, encoding="utf-8")
+    section = _spoolman_map_section(printer_id)
+    clean = {int(k): int(v) for k, v in (slot_spools or {}).items() if int(v) > 0}
+    if clean:
+        if not cfg.has_section(section):
+            cfg.add_section(section)
+        cfg[section]["slot_spools"] = ",".join(f"{k}:{v}" for k, v in sorted(clean.items()))
+    elif cfg.has_option(section, "slot_spools"):
+        cfg.remove_option(section, "slot_spools")
     with open(path, "w", encoding="utf-8") as f:
         cfg.write(f)
     return True
@@ -308,17 +457,41 @@ def get(key: str, default: str = "") -> str:
     return os.environ.get(key, default)
 
 
-# Häufig verwendete Shortcuts
+def _safe_int(value: str, default: int) -> int:
+    """Falls back to `default` instead of raising on a non-numeric value.
+
+    All of these run at module import time - an uncaught ValueError here
+    (e.g. from a hand-edited config.ini with a typo like `mqtt_port = 98833x`)
+    would crash the entire bridge before it even starts, with a raw traceback
+    instead of a clear diagnostic. list_printers() already guards this same
+    class of input the same way; this applies it to the module-level
+    shortcuts too."""
+    try:
+        return int(value)
+    except (TypeError, ValueError):
+        log.warning("config: expected a number, got %r - using default %r", value, default)
+        return default
+
+
+# Frequently used shortcuts
 PRINTER_IP       = get("PRINTER_IP",       "")
-MQTT_PORT        = int(get("MQTT_PORT",    "9883"))
+MQTT_PORT        = _safe_int(get("MQTT_PORT", "9883"), 9883)
 USERNAME         = get("MQTT_USERNAME",    "")
 PASSWORD         = get("MQTT_PASSWORD",    "")
 MODE_ID          = get("MODE_ID",          "")
 DEVICE_ID        = get("DEVICE_ID",        "")
+POWER_ON_URL     = get("POWER_ON_URL",     "")
+POWER_OFF_URL    = get("POWER_OFF_URL",    "")
+POWER_STATUS_URL = get("POWER_STATUS_URL", "")
 DEFAULT_AMS_SLOT = get("DEFAULT_AMS_SLOT", "auto")
-AUTO_LEVELING    = int(get("AUTO_LEVELING","1"))
-CAMERA_ON_PRINT  = int(get("CAMERA_ON_PRINT","0"))
-WEB_UPLOAD_WARNING = int(get("WEB_UPLOAD_WARNING", "1"))
-PRINT_START_DIALOG = int(get("PRINT_START_DIALOG", get("FILE_READY_DIALOG", "1")))
+AUTO_LEVELING           = _safe_int(get("AUTO_LEVELING",          "1"), 1)
+VIBRATION_COMPENSATION  = _safe_int(get("VIBRATION_COMPENSATION", "0"), 0)
+CAMERA_ON_PRINT         = _safe_int(get("CAMERA_ON_PRINT",        "0"), 0)
+WEB_UPLOAD_WARNING = _safe_int(get("WEB_UPLOAD_WARNING", "1"), 1)
+DELETE_PRINTER_FILE_AFTER_PRINT = _safe_int(get("DELETE_PRINTER_FILE_AFTER_PRINT", "0"), 0)
+PRINT_START_DIALOG = _safe_int(get("PRINT_START_DIALOG", get("FILE_READY_DIALOG", "1")), 1)
 SPOOLMAN_SERVER    = get("SPOOLMAN_SERVER",    "")
-SPOOLMAN_SYNC_RATE = int(get("SPOOLMAN_SYNC_RATE", "0"))
+SPOOLMAN_SYNC_RATE = _safe_int(get("SPOOLMAN_SYNC_RATE", "0"), 0)
+BRIDGE_HOST_IP     = get("BRIDGE_HOST_IP",     "")
+POLL_INTERVAL      = _safe_int(get("POLL_INTERVAL",  "3"), 3)
+VERBOSE_HTTP_LOG   = _safe_int(get("VERBOSE_HTTP_LOG", "0"), 0)

docker-compose-KX.yml

@@ -1,8 +1,8 @@
 # KobraX Full Stack — KX-Bridge + Obico Self-Hosted + Spoolman
 #
-# Für Portainer: Stack → Add Stack → Upload → diese Datei wählen
+# For Portainer: Stack → Add Stack → Upload → select this file
 #
-# Voraussetzung: Obico-Images einmalig in Gitea-Registry pushen:
+# Prerequisite: push the Obico images to the Gitea registry once:
 #   docker tag obico-server-web:latest    gitea.it-drui.de/viewit/obico-web:latest
 #   docker tag obico-server-ml_api:latest gitea.it-drui.de/viewit/obico-ml:latest
 #   docker tag obico-server-tasks:latest  gitea.it-drui.de/viewit/obico-tasks:latest
@@ -10,14 +10,14 @@
 #   docker push gitea.it-drui.de/viewit/obico-ml:latest
 #   docker push gitea.it-drui.de/viewit/obico-tasks:latest
 #
-# Persistente Daten: /mnt/dockerdata/KobraXStack/<service>/
+# Persistent data: /mnt/dockerdata/KobraXStack/<service>/
 #
 # Ports:
-#   7125  — KX-Bridge  (Moonraker-API)
-#   3334  — Obico      (Web-UI)
-#   7912  — Spoolman   (Web-UI)
+#   7125  — KX-Bridge  (Moonraker API)
+#   3334  — Obico      (Web UI)
+#   7912  — Spoolman   (Web UI)
 #
-# Obico Admin-Account nach dem ersten Start:
+# Obico admin account after first start:
 #   docker exec obico-web python manage.py createsuperuser
 
 x-obico-base: &obico-base
@@ -162,12 +162,12 @@ services:
         max-size: "10m"
         max-file: "3"
 
-  # ── moonraker-obico Plugin ──────────────────────────────────
-  # Verbindet KX-Bridge mit dem Obico-Server (Spaghetti-Detektion, Remote-UI)
-  # Voraussetzung: /mnt/dockerdata/KobraXStack/moonraker-obico/moonraker-obico.cfg
-  # muss existieren und einen gültigen auth_token enthalten.
+  # ── moonraker-obico plugin ──────────────────────────────────
+  # Connects KX-Bridge to the Obico server (spaghetti detection, remote UI)
+  # Prerequisite: /mnt/dockerdata/KobraXStack/moonraker-obico/moonraker-obico.cfg
+  # must exist and contain a valid auth_token.
   #
-  # Token holen (nach erstem obico-web Start):
+  # Getting a token (after the first obico-web start):
   #   docker exec obico-web python manage.py shell -c "
   #   from app.models import OneTimeVerificationCode, User
   #   from django.utils import timezone; from datetime import timedelta; import random
@@ -175,7 +175,7 @@ services:
   #   c = OneTimeVerificationCode.objects.create(user=u, code='%06d' % random.randint(100000,999999), expired_at=timezone.now()+timedelta(hours=2))
   #   print('CODE:', c.code)"
   #   curl -X POST 'http://localhost:3334/api/v1/octo/verify/?code=<CODE>'
-  #   → printer.auth_token aus der Antwort in die cfg eintragen
+  #   → enter printer.auth_token from the response into the cfg
   moonraker-obico:
     image: gitea.it-drui.de/viewit/moonraker-obico:latest
     container_name: moonraker-obico
@@ -195,7 +195,7 @@ networks:
   kobrax-stack:
     driver: bridge
 
-# Verzeichnisse müssen auf dem Host existieren:
+# Directories must exist on the host:
 # mkdir -p /mnt/dockerdata/KobraXStack/kx-bridge/config \
 #           /mnt/dockerdata/KobraXStack/kx-bridge/data \
 #           /mnt/dockerdata/KobraXStack/spoolman \
@@ -203,8 +203,8 @@ networks:
 #           /mnt/dockerdata/KobraXStack/obico/frontend \
 #           /mnt/dockerdata/KobraXStack/obico/redis \
 #           /mnt/dockerdata/KobraXStack/moonraker-obico/logs
-# Spoolman benötigt UID/GID 1000:
+# Spoolman requires UID/GID 1000:
 # sudo chown -R 1000:1000 /mnt/dockerdata/KobraXStack/spoolman
 #
-# moonraker-obico Config anlegen (auth_token nach Obico-Setup eintragen):
+# Create the moonraker-obico config (enter auth_token after Obico setup):
 # cp /path/to/moonraker-obico.cfg.example /mnt/dockerdata/KobraXStack/moonraker-obico/moonraker-obico.cfg

docker-compose.yml

@@ -10,6 +10,8 @@ services:
       - ./.env:/app/.env:ro
     ports:
       - "7125-7130:7125-7130"
+    # environment:
+    #   - BRIDGE_HOST_IP=192.168.1.100   # LAN-IP des Docker-Hosts (für korrekte Log-Anzeige)
     restart: unless-stopped
     logging:
       driver: json-file

env_loader.py

@@ -1,6 +1,6 @@
 """
-env_loader.py – lädt Verbindungsparameter aus .env (Repo-Root oder Arbeitsverzeichnis).
-Umgebungsvariablen haben Vorrang vor .env-Werten.
+env_loader.py - loads connection parameters from .env (repo root or working directory).
+Environment variables take precedence over .env values.
 """
 import os
 import sys
@@ -39,15 +39,21 @@ def get(key: str, default: str = "") -> str:
     return os.environ.get(key, default)
 
 
-# Häufig verwendete Shortcuts
+# Frequently used shortcuts
 PRINTER_IP       = get("PRINTER_IP",       "")
 MQTT_PORT        = int(get("MQTT_PORT", "9883"))
 USERNAME         = get("MQTT_USERNAME",    "")
 PASSWORD         = get("MQTT_PASSWORD",    "")
 MODE_ID          = get("MODE_ID",          "")
 DEVICE_ID        = get("DEVICE_ID",        "")
+POWER_ON_URL     = get("POWER_ON_URL",     "")
+POWER_OFF_URL    = get("POWER_OFF_URL",    "")
+POWER_STATUS_URL = get("POWER_STATUS_URL", "")
 DEFAULT_AMS_SLOT = get("DEFAULT_AMS_SLOT", "auto")
-AUTO_LEVELING    = int(get("AUTO_LEVELING", "1"))
-CAMERA_ON_PRINT  = int(get("CAMERA_ON_PRINT", "0"))
+AUTO_LEVELING            = int(get("AUTO_LEVELING", "1"))
+VIBRATION_COMPENSATION   = int(get("VIBRATION_COMPENSATION", "0"))
+CAMERA_ON_PRINT          = int(get("CAMERA_ON_PRINT", "0"))
 WEB_UPLOAD_WARNING = int(get("WEB_UPLOAD_WARNING", "1"))
+DELETE_PRINTER_FILE_AFTER_PRINT = int(get("DELETE_PRINTER_FILE_AFTER_PRINT", "0"))
 PRINT_START_DIALOG = int(get("PRINT_START_DIALOG", get("FILE_READY_DIALOG", "1")))
+BRIDGE_HOST_IP   = get("BRIDGE_HOST_IP", "")

kobrax_client.py

@@ -1,10 +1,10 @@
 """
 kobrax_client.py – Anycubic Kobra X LAN-MQTT-Client
 
-Protokoll vollständig rekonstruiert via Sniffer 2026-04-17 (953 Nachrichten).
+Protocol fully reconstructed via sniffer 2026-04-17 (953 messages).
 
 Voraussetzungen:
-  - /tmp/anycubic_slicer.crt und .key (aus cloud_mqtt.dll @ 0x2ed5b0 / 0x2edce0)
+  - /tmp/anycubic_slicer.crt and .key (from cloud_mqtt.dll @ 0x2ed5b0 / 0x2edce0)
   - Drucker im LAN-Modus erreichbar auf Port 9883
 
 Verwendung:
@@ -101,6 +101,46 @@ def _parse_publish(pkt: bytes):
     return topic, payload
 
 
+def _enable_tcp_keepalive(sock: socket.socket) -> None:
+    """Without this, a printer that goes dark without a clean TCP close (e.g.
+    unplugged, not gracefully shut down) leaves the socket looking alive to
+    is_connected() for as long as the OS's default dead-connection timeout
+    (often 15+ minutes on Linux) - sendall() on a half-open connection is
+    buffered by the kernel and doesn't fail immediately, so the poll loop's
+    is_connected() check (kobrax_moonraker_bridge.py's _poll_loop) never
+    sees the failure it needs to flip kobra_state to "offline". Short
+    keepalive probes make the OS notice and fail the socket within seconds
+    instead. Linux/macOS only (TCP_KEEPIDLE/INTVL/CNT); best-effort on other
+    platforms - not fatal if unsupported.
+
+    SO_KEEPALIVE alone is NOT enough, verified live by unplugging a real
+    printer mid-connection: keepalive probes only fire while the connection
+    is idle (no unacknowledged data outstanding). If the printer disappears
+    while a send is still in flight - the common case, since the poll loop
+    sends a request roughly every poll_interval - the kernel instead retries
+    that specific send via the normal TCP retransmission timer
+    (tcp_retries2, default 15 attempts with exponential backoff = 13-30+
+    minutes on Linux), which keepalive settings don't affect at all.
+    TCP_USER_TIMEOUT (Linux-specific) closes that gap: it caps how long ANY
+    unacknowledged data may sit in the send queue before the kernel gives up
+    on the connection outright, regardless of which mechanism (keepalive or
+    retransmission) would otherwise still be retrying."""
+    try:
+        sock.setsockopt(socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1)
+        if hasattr(socket, "TCP_KEEPIDLE"):
+            sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_KEEPIDLE, 5)
+        elif hasattr(socket, "TCP_KEEPALIVE"):  # macOS
+            sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_KEEPALIVE, 5)
+        if hasattr(socket, "TCP_KEEPINTVL"):
+            sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_KEEPINTVL, 3)
+        if hasattr(socket, "TCP_KEEPCNT"):
+            sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_KEEPCNT, 3)
+        if hasattr(socket, "TCP_USER_TIMEOUT"):
+            sock.setsockopt(socket.IPPROTO_TCP, socket.TCP_USER_TIMEOUT, 15000)
+    except OSError as e:
+        log.debug("TCP keepalive not fully supported on this platform: %s", e)
+
+
 # ---------------------------------------------------------------------------
 # KobraXClient
 # ---------------------------------------------------------------------------
@@ -121,22 +161,42 @@ class KobraXClient:
         self._buf     = b""
         self._pid     = 1
         self._lock    = threading.Lock()
-        # Generations-Marker: wird bei jedem Socket-Swap/Close erhöht, damit der
-        # Reader-Thread erkennt wenn _reconnect/_do_connect den Socket unter ihm
-        # ersetzt hat (Issue #53). Schützt gegen recv auf einem stale fd.
+        # Generation marker: incremented on every socket swap/close so the
+        # reader thread notices when _reconnect/_do_connect swapped the socket
+        # underneath it (Issue #53). Protects against recv on a stale fd.
         self._sock_gen = 0
         self._running = False
+        # Guards _reconnect() against concurrent invocation - both the reader
+        # thread (keepalive ping failure) and publish()/publish_web() (send
+        # failure) can trigger a reconnect independently. Without this, two
+        # threads could race into _do_connect() at once, each opening its own
+        # competing TLS handshake to a printer that likely only accepts one
+        # mTLS session at a time (Issue #105).
+        self._reconnect_lock = threading.Lock()
 
         # Pending requests by msgid (for response ACK)
         self._pending_msgid: dict[str, dict] = {}
         # Pending requests by msg_type/report topic suffix
         self._pending_report: dict[str, dict] = {}
+        # Guards _pending_msgid/_pending_report against concurrent mutation:
+        # the reader thread resolves entries in _dispatch() while publish()
+        # (called from the poll loop and, via run_in_executor, HTTP handler
+        # threads) registers/cleans them up - without this, two concurrent
+        # publish() calls for the same msg_type can race on the
+        # check-then-set for a report_key slot, and _dispatch() could observe
+        # a dict mid-mutation.
+        self._pending_lock = threading.Lock()
 
         # Optional callbacks: topic_suffix → callable(payload_dict)
         self.callbacks: dict[str, callable] = {}
 
         # Dedup: last hash per topic suffix to suppress repeated identical messages
         self._last_rx_hash: dict[str, str] = {}
+        # Debug switch (MQTT_RAW_LOG=1): logs every RX message unfiltered on
+        # INFO, including dedup'd duplicates and topics with no registered
+        # callback - for capturing printer behavior the bridge doesn't
+        # normally surface (e.g. reverse-engineering a rejected command).
+        self._raw_log = os.environ.get("MQTT_RAW_LOG", "").strip().lower() in ("1", "true", "yes")
         # Fields that change every tick and should be stripped before dedup-hashing
         _VOLATILE = {"timestamp", "msgid", "progress", "curr_layer",
                      "curr_nozzle_temp", "curr_hotbed_temp",
@@ -162,9 +222,9 @@ class KobraXClient:
         if not os.path.exists(CERT_FILE) or not os.path.exists(KEY_FILE):
             raise FileNotFoundError(
                 f"TLS-Zertifikate fehlen: anycubic_slicer.crt + anycubic_slicer.key "
-                f"müssen neben der kx-bridge Binary liegen ({_SCRIPT_DIR}/). "
-                f"Lade anycubic-certs.zip vom Gitea-Release herunter und entpacke "
-                f"die Dateien dorthin."
+                f"must sit next to the kx-bridge binary ({_SCRIPT_DIR}/). "
+                f"Download anycubic-certs.zip from the Gitea release and extract "
+                f"the files there."
             )
         ctx = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT)
         ctx.check_hostname = False
@@ -172,11 +232,12 @@ class KobraXClient:
         ctx.set_ciphers("DEFAULT:@SECLEVEL=0")
         ctx.load_cert_chain(CERT_FILE, KEY_FILE)
 
-        # Socket als lokale Variable aufbauen — der Handshake (Connect + CONNACK)
-        # läuft OHNE gehaltenes Lock, damit ein langsamer Connect die Sender nicht
-        # einfriert. Erst der fertige Socket wird unter Lock eingeschwenkt (#53).
+        # Build the socket as a local variable - the handshake (connect + CONNACK)
+        # runs WITHOUT holding the lock so a slow connect does not freeze
+        # senders. Only the finished socket is swapped in under the lock (#53).
         _ai      = socket.getaddrinfo(self.host, self.port, socket.AF_INET, socket.SOCK_STREAM)
         raw      = socket.create_connection(_ai[0][4], timeout=5)
+        _enable_tcp_keepalive(raw)
         new_sock = ctx.wrap_socket(raw)
         log.info("TLS connected  cipher=%s", new_sock.cipher()[0])
 
@@ -196,7 +257,7 @@ class KobraXClient:
             self._sock = new_sock
             self._sock_gen += 1
             self._buf = b""
-        self._subscribe(self._sub_topic())  # nimmt das Lock selbst — nicht verschachteln
+        self._subscribe(self._sub_topic())  # takes the lock itself - do not nest
         log.debug("MQTT connected to %s:%s", self.host, self.port)
 
     def connect(self):
@@ -206,10 +267,10 @@ class KobraXClient:
         time.sleep(0.3)
 
     def _ensure_reader(self):
-        """Stellt sicher dass der Reader-Thread lebt. Wenn der Reader nach einer
-        früheren disconnect/reconnect-Sequenz oder einem unbehandelten Fehler
-        gestorben ist, würden empfangene Replies sonst nie ankommen — publish()
-        würde dann zwar senden, aber auf Antworten ewig warten."""
+        """Ensures the reader thread is alive. If the reader died after a
+        previous disconnect/reconnect sequence or an unhandled error,
+        received replies would never arrive - publish()
+        would still send but wait for replies forever."""
         if not self._running:
             return  # gewollter disconnect
         t = getattr(self, "_reader_thread", None)
@@ -231,41 +292,81 @@ class KobraXClient:
             self._sock = None
             self._sock_gen += 1
 
-    def _reconnect(self):
-        """Persistenter Reconnect: versucht endlos weiter bis der Drucker wieder
-        antwortet oder disconnect() gerufen wurde. Backoff cappt bei 60 s. Die
-        ersten 5 Versuche loggen als WARNING (akute Verbindungsstörung), danach
-        nur DEBUG um Log-Spam bei langem Drucker-Ausfall (z.B. über Nacht
-        ausgeschaltet) zu vermeiden."""
-        log.warning("Verbindung verloren – reconnect…")
-        # Close + Invalidierung unter Lock, damit kein Sender mitten im sendall
-        # auf den gerade geschlossenen Socket trifft (Issue #53).
+    def is_connected(self) -> bool:
+        """Thread-safe check whether the MQTT socket is currently up. Used by
+        the bridge's poll loop to detect a dead session even when publish()
+        already swallowed the send failure and returned None instead of
+        raising (Issue #105) - a TCP-reachable printer alone doesn't mean the
+        MQTT/TLS session is still alive."""
         with self._lock:
-            try:
-                if self._sock is not None:
-                    self._sock.close()
-            except Exception:
-                pass
-            self._sock = None
-            self._sock_gen += 1
-        delays = [2, 4, 8, 15, 30, 60]
-        attempt = 0
-        while self._running:
-            delay = delays[min(attempt, len(delays) - 1)]
-            try:
-                self._do_connect()
-                log.info("Reconnect erfolgreich (nach %d Versuchen)", attempt + 1)
-                return True
-            except Exception as e:
-                attempt += 1
-                lvl = log.warning if attempt <= 5 else log.debug
-                lvl("Reconnect fehlgeschlagen (%s, Versuch %d), warte %ss…", e, attempt, delay)
-                # Geteiltes Sleep damit disconnect() den Loop schneller bricht.
-                slept = 0.0
-                while slept < delay and self._running:
-                    time.sleep(min(0.5, delay - slept))
-                    slept += 0.5
-        return False  # nur wenn disconnect() gerufen wurde
+            return self._sock is not None
+
+    def _reconnect(self, wait_if_in_progress: bool = True, persist: bool = True):
+        """Reconnect the MQTT/TLS session. With persist=True (the default, used
+        by the reader-thread keepalive path) it keeps retrying forever until
+        the printer responds or disconnect() was called, backoff capped at 60s.
+        The first 5 attempts log as WARNING (acute connection issue), afterwards
+        only DEBUG to avoid log spam during long printer outages (e.g. switched off).
+
+        Guarded by _reconnect_lock (Issue #105): if another thread's reconnect
+        is already in flight, this call normally waits for it to finish instead
+        of starting a second, competing _do_connect() - the printer likely only
+        accepts one mTLS session at a time, so two parallel handshakes would
+        just interfere with each other and neither converges.
+
+        wait_if_in_progress=False + persist=False are used by the poll loop's
+        publish()/publish_web(): that thread MUST return promptly so the poll
+        loop can observe the dead session (via is_connected()) and flip
+        kobra_state to "offline". It must neither block on the lock waiting for
+        the reader thread's persistent reconnect (wait_if_in_progress=False),
+        nor run the multi-minute backoff loop itself (persist=False -> at most
+        one immediate attempt). Otherwise the poll loop hangs inside publish()
+        for the entire outage and the dashboard stays stuck on the last known
+        state - the exact bug seen when a printer was unplugged mid-connection."""
+        if not self._reconnect_lock.acquire(blocking=False):
+            if not wait_if_in_progress:
+                return self._sock is not None
+            self._reconnect_lock.acquire()
+            self._reconnect_lock.release()
+            return self._sock is not None
+        try:
+            log.warning("Connection lost - reconnecting...")
+            # Close + invalidation under the lock so no sender is mid-sendall
+            # auf den gerade geschlossenen Socket trifft (Issue #53).
+            with self._lock:
+                try:
+                    if self._sock is not None:
+                        self._sock.close()
+                except Exception:
+                    pass
+                self._sock = None
+                self._sock_gen += 1
+            delays = [2, 4, 8, 15, 30, 60]
+            attempt = 0
+            while self._running:
+                delay = delays[min(attempt, len(delays) - 1)]
+                try:
+                    self._do_connect()
+                    log.info("Reconnect successful (after %d attempts)", attempt + 1)
+                    return True
+                except Exception as e:
+                    attempt += 1
+                    if not persist:
+                        # One-shot: don't block the caller (poll loop) in the
+                        # backoff loop - leave persistent retrying to the
+                        # reader thread's keepalive path.
+                        log.debug("Reconnect (one-shot) failed: %s", e)
+                        return False
+                    lvl = log.warning if attempt <= 5 else log.debug
+                    lvl("Reconnect fehlgeschlagen (%s, Versuch %d), warte %ss…", e, attempt, delay)
+                    # Split sleep so disconnect() breaks the loop faster.
+                    slept = 0.0
+                    while slept < delay and self._running:
+                        time.sleep(min(0.5, delay - slept))
+                        slept += 0.5
+            return False  # only when disconnect() was called
+        finally:
+            self._reconnect_lock.release()
 
     def _subscribe(self, topic: str):
         with self._lock:
@@ -290,15 +391,15 @@ class KobraXClient:
                             ping_ok = True
                     except Exception:
                         ping_ok = False
-                # _reconnect() AUSSERHALB des Locks aufrufen — es nimmt das Lock
-                # selbst, und threading.Lock ist nicht reentrant (sonst Deadlock).
+                # Call _reconnect() OUTSIDE the lock - it takes the lock
+                # itself, and threading.Lock is not reentrant (deadlock otherwise).
                 if not ping_ok:
                     if self._running and not self._reconnect():
                         break
                 last_ping = time.time()
-            # Aktuellen Socket + Generation unter Lock greifen, damit ein
-            # paralleler _reconnect/_do_connect-Swap uns nicht auf einem stale
-            # fd pollen lässt (Issue #53).
+            # Grab the current socket + generation under the lock so a
+            # parallel _reconnect/_do_connect swap does not leave us polling
+            # a stale fd (Issue #53).
             with self._lock:
                 sock = self._sock
                 gen  = self._sock_gen
@@ -306,37 +407,37 @@ class KobraXClient:
                 time.sleep(0.05)
                 continue
 
-            # Idle-Wartezeit OHNE Lock — select probt nur die Bereitschaft, so
-            # blockiert der Reader während Leerlauf nie das gemeinsame Lock.
+            # Idle wait WITHOUT the lock - select only probes readiness, so
+            # the reader never blocks the shared lock while idle.
             try:
                 ready, _, _ = select.select([sock], [], [], 0.2)
             except (OSError, ValueError):
-                # fd geschlossen/ungültig (Reconnect oder Disconnect mitten im select)
+                # fd closed/invalid (reconnect or disconnect mid-select)
                 if not self._running:
                     break
                 time.sleep(0.05)
                 continue
             if not ready:
-                continue  # Leerlauf, kein Lock gehalten
+                continue  # idle, no lock held
 
-            # Daten liegen an: Lock kurz greifen für das eine recv, serialisiert
-            # gegen alle sendall-Caller. recv blockiert nicht lange (select sagte
-            # ready, Socket-Timeout ist 0.2s).
+            # Data pending: briefly take the lock for the single recv, serialized
+            # against all sendall callers. recv does not block long (select said
+            # ready, socket timeout is 0.2s).
             try:
                 with self._lock:
-                    # Socket könnte zwischen select und hier ersetzt worden sein.
+                    # The socket could have been swapped between select and here.
                     if self._sock_gen != gen or self._sock is not sock:
                         continue
                     data = sock.recv(65536)
                 if not data:
-                    # Windows SSL kann kurzzeitig b"" liefern ohne echten EOF
+                    # Windows SSL can briefly return b"" without a real EOF
                     _empty_count += 1
                     if _empty_count >= 5:
                         raise ConnectionResetError("EOF")
                     continue
                 _empty_count = 0
                 self._buf += data
-                self._drain()  # außerhalb des Locks — Dispatch/event.set() bleibt prompt
+                self._drain()  # outside the lock - dispatch/event.set() stays prompt
             except ssl.SSLWantReadError:
                 continue
             except socket.timeout:
@@ -353,34 +454,46 @@ class KobraXClient:
     def _drain(self):
         buf = self._buf
         idx = 0
-        while idx < len(buf):
-            ptype = buf[idx] & 0xF0
-            i = idx + 1
-            mul = 1
-            rem = 0
-            while i < len(buf):
-                b = buf[i]
-                rem += (b & 0x7F) * mul
-                mul *= 128
-                i += 1
-                if not (b & 0x80):
+        try:
+            while idx < len(buf):
+                ptype = buf[idx] & 0xF0
+                i = idx + 1
+                mul = 1
+                rem = 0
+                while i < len(buf):
+                    b = buf[i]
+                    rem += (b & 0x7F) * mul
+                    mul *= 128
+                    i += 1
+                    if not (b & 0x80):
+                        break
+                if i + rem > len(buf):
                     break
-            if i + rem > len(buf):
-                break
-            pkt = buf[i:i + rem]
-            idx = i + rem
+                pkt = buf[i:i + rem]
+                idx = i + rem
 
-            if ptype == 0x30:
-                topic, raw_payload = _parse_publish(pkt)
-                if topic is None:
-                    continue
-                try:
-                    payload = json.loads(raw_payload)
-                except Exception:
-                    payload = {"_raw": raw_payload.decode("utf-8", errors="replace")}
-                self._dispatch(topic, payload)
-
-        self._buf = buf[idx:]
+                if ptype == 0x30:
+                    topic, raw_payload = _parse_publish(pkt)
+                    if topic is None:
+                        continue
+                    try:
+                        payload = json.loads(raw_payload)
+                    except Exception:
+                        payload = {"_raw": raw_payload.decode("utf-8", errors="replace")}
+                    try:
+                        self._dispatch(topic, payload)
+                    except Exception as e:
+                        # A single malformed/unexpected message (e.g. valid JSON
+                        # that isn't an object, like a bare number or list) must
+                        # not be reprocessed forever: without this, an exception
+                        # here would skip the buffer-advance below, leaving the
+                        # same bad packet at the front of self._buf so every
+                        # future _drain() call crashes on it again - each one
+                        # forcing a reconnect via the reader loop's exception
+                        # handler, an endless self-inflicted reconnect loop.
+                        log.warning("dispatch error for %s: %s", topic, e)
+        finally:
+            self._buf = buf[idx:]
 
     def _dedup_hash(self, suffix: str, payload: dict) -> str:
         """Hash payload ignoring volatile per-tick fields for dedup check."""
@@ -391,8 +504,14 @@ class KobraXClient:
         return hashlib.md5(json.dumps(stable, sort_keys=True).encode(), usedforsecurity=False).hexdigest()
 
     def _dispatch(self, topic: str, payload: dict):
+        if not isinstance(payload, dict):
+            log.warning("dispatch: non-dict payload on %s: %r", topic, payload)
+            return
         suffix = "/".join(topic.split("/")[-2:])
 
+        if self._raw_log:
+            log.info("RX [raw] %s  %s", topic, json.dumps(payload, ensure_ascii=False))
+
         # Structured RX log with dedup suppression
         h = self._dedup_hash(suffix, payload)
         is_dup = self._last_rx_hash.get(suffix) == h
@@ -415,18 +534,29 @@ class KobraXClient:
                 log.info("RX %-25s  state=%-12s  data=%s",
                          suffix, state, json.dumps(payload.get("data"), ensure_ascii=False))
 
-        # Resolve by report topic suffix (e.g. "info/report")
-        if suffix in self._pending_report:
-            entry = self._pending_report[suffix]
-            entry["result"] = payload
-            entry["event"].set()
+        msgid = payload.get("msgid")
+        with self._pending_lock:
+            report_entry = self._pending_report.get(suffix)
+            msgid_entry  = self._pending_msgid.get(msgid) if msgid else None
+
+        # Resolve by report topic suffix (e.g. "info/report"). If the payload
+        # carries a msgid that doesn't match what this waiter is actually
+        # expecting, it's a stale/late reply for a different, already-timed-out
+        # request that happens to share the same report_key - don't deliver it
+        # to the wrong caller.
+        if report_entry is not None:
+            entry_msgid = report_entry.get("msgid")
+            if not entry_msgid or not msgid or entry_msgid == msgid:
+                report_entry["result"] = payload
+                report_entry["event"].set()
+            else:
+                log.debug("dispatch: msgid mismatch for %s report (waiting=%s, got=%s) - ignoring stale reply",
+                           suffix, entry_msgid, msgid)
 
         # Resolve by msgid (for generic response ACK)
-        msgid = payload.get("msgid")
-        if msgid and msgid in self._pending_msgid:
-            entry = self._pending_msgid[msgid]
-            entry["result"] = payload
-            entry["event"].set()
+        if msgid_entry is not None:
+            msgid_entry["result"] = payload
+            msgid_entry["event"].set()
 
         # User callbacks by topic suffix (last two path components)
         if suffix in self.callbacks:
@@ -445,8 +575,8 @@ class KobraXClient:
     # -- Publish + request/response ------------------------------------------
 
     def publish(self, msg_type: str, action: str, data=None, timeout: float = 5.0) -> dict | None:
-        # Falls Reader-Thread aus historischen Gründen tot ist, wiederbeleben —
-        # sonst würden Replies nie ankommen und event.wait() läuft ins Timeout.
+        # If the reader thread is dead for historical reasons, revive it -
+        # otherwise replies would never arrive and event.wait() would time out.
         self._ensure_reader()
         msgid   = str(uuid.uuid4())
         payload = json.dumps({
@@ -462,16 +592,21 @@ class KobraXClient:
         # Also register by report topic as fallback for responses without msgid.
         report_key = f"{msg_type}/report"
         event  = threading.Event()
-        entry  = {"event": event, "result": None}
-        self._pending_msgid[msgid] = entry
-        # Only register report-key waiter if nobody else is waiting on it
+        # entry carries its own msgid so _dispatch()'s report-suffix path can
+        # confirm a reply actually belongs to THIS request before delivering
+        # it - without that, a late reply for an already-timed-out request A
+        # could be handed to a newer request B waiting on the same report_key.
+        entry  = {"event": event, "result": None, "msgid": msgid}
         report_registered = False
-        if report_key not in self._pending_report:
-            self._pending_report[report_key] = entry
-            report_registered = True
+        with self._pending_lock:
+            self._pending_msgid[msgid] = entry
+            # Only register report-key waiter if nobody else is waiting on it
+            if report_key not in self._pending_report:
+                self._pending_report[report_key] = entry
+                report_registered = True
 
         topic = self._pub_topic(msg_type)
-        # Status-Poll-TX (query/getInfo) ist reines Rauschen (alle paar Sekunden) →
+        # Status poll TX (query/getInfo) is pure noise (every few seconds) ->
         # auf DEBUG. Aktions-TX (start/set/control/move/…) bleibt INFO sichtbar.
         _tx_level = logging.DEBUG if action in ("query", "getInfo") else logging.INFO
         log.log(_tx_level, "TX %-25s  action=%-12s  data=%s",
@@ -482,31 +617,38 @@ class KobraXClient:
                 self._sock.sendall(_build_publish(topic, payload))
         except Exception as e:
             log.error("send error: %s, reconnecting…", e)
-            self._pending_msgid.pop(msgid, None)
-            if report_registered:
-                self._pending_report.pop(report_key, None)
-            if not self._reconnect():
+            with self._pending_lock:
+                self._pending_msgid.pop(msgid, None)
+                if report_registered:
+                    self._pending_report.pop(report_key, None)
+            # Non-blocking: never hang the poll-loop thread inside publish()
+            # while a reconnect is running / during backoff (see _reconnect
+            # docstring) - it must return so kobra_state can flip to "offline".
+            if not self._reconnect(wait_if_in_progress=False, persist=False):
                 return None
             # retry once after reconnect
             try:
                 with self._lock:
                     self._sock.sendall(_build_publish(topic, payload))
-                self._pending_msgid[msgid] = entry
-                if report_registered:
-                    self._pending_report[report_key] = entry
+                with self._pending_lock:
+                    self._pending_msgid[msgid] = entry
+                    if report_registered:
+                        self._pending_report[report_key] = entry
             except Exception:
                 return None
 
         if timeout <= 0:
-            self._pending_msgid.pop(msgid, None)
-            if report_registered:
-                self._pending_report.pop(report_key, None)
+            with self._pending_lock:
+                self._pending_msgid.pop(msgid, None)
+                if report_registered:
+                    self._pending_report.pop(report_key, None)
             return None
 
         received = event.wait(timeout)
-        self._pending_msgid.pop(msgid, None)
-        if report_registered:
-            self._pending_report.pop(report_key, None)
+        with self._pending_lock:
+            self._pending_msgid.pop(msgid, None)
+            if report_registered:
+                self._pending_report.pop(report_key, None)
         if not received:
             return None
         return entry["result"]
@@ -531,11 +673,12 @@ class KobraXClient:
                 self._sock.sendall(_build_publish(topic, payload))
         except Exception as e:
             log.error("web send error: %s, reconnecting…", e)
-            # Reconnect triggern (analog zu publish()); ohne Retry weil
-            # fire-and-forget — der nächste Aufruf wird auf den frischen Socket
-            # treffen.
+            # Trigger a reconnect (like publish()); no retry because it is
+            # fire-and-forget - the next call will hit the fresh socket.
+            # Non-blocking for the same reason as publish() (see _reconnect
+            # docstring) - never hang this thread through a backoff loop.
             try:
-                self._reconnect()
+                self._reconnect(wait_if_in_progress=False, persist=False)
             except Exception:
                 pass
 
@@ -579,13 +722,13 @@ class KobraXClient:
     # -- Part-Skip ("Exclude Object") ---------------------------------------
 
     def query_skip_objects(self) -> dict | None:
-        """Fragt den Drucker nach der aktuellen Objekt-/Skip-Liste."""
+        """Asks the printer for the current object/skip list."""
         return self.publish("skip", "query_obj")
 
     def skip_objects(self, names: list[str]) -> dict | None:
-        """Überspringt die genannten Objekte – auch mid-print möglich.
+        """Skips the named objects - also possible mid-print.
 
-        Namen entsprechen den EXCLUDE_OBJECT_DEFINE NAME=… Einträgen
+        Names correspond to the EXCLUDE_OBJECT_DEFINE NAME=... entries
         im GCode-Header bzw. file_details.objects_skip_parts.
         """
         return self.publish("skip", "start", {"objects_skip_parts": list(names)})
@@ -610,7 +753,9 @@ class KobraXClient:
                 raise RuntimeError("Could not get info/report for upload URL")
             upload_url = info["data"]["urls"]["fileUploadurl"]
         # parse token from URL query string
-        token = upload_url.split("?s=")[1] if "?s=" in upload_url else ""
+        if "?s=" not in upload_url:
+            raise RuntimeError(f"Upload: no session token ('?s=') in upload URL: {upload_url!r}")
+        token = upload_url.split("?s=")[1]
 
         with open(filepath, "rb") as f:
             file_data = f.read()
@@ -653,26 +798,32 @@ class KobraXClient:
             f"Connection: close\r\n\r\n"
         ).encode()
 
-        # Connect-Timeout kurz (LAN). Während sendall() darf der Socket so
-        # lange brauchen wie nötig — bei großen Dateien (>100 MB) und
-        # 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).
+        # Short connect timeout (LAN). During sendall() the socket may take
+        # as long as needed - with large files (>100 MB) and slower WiFi
+        # at the printer, pushing otherwise takes >30 s and would falsely
+        # trip the connect timeout. The read timeout afterwards is generous
+        # (the printer processes the file before replying).
         _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)
-        response = b""
         try:
-            while True:
-                chunk = sock.recv(65536)
-                if not chunk:
-                    break
-                response += chunk
-        except socket.timeout:
-            pass
-        sock.close()
+            sock.settimeout(None)  # blocking during send
+            sock.sendall(headers + body)
+            sock.settimeout(180)
+            response = b""
+            try:
+                while True:
+                    chunk = sock.recv(65536)
+                    if not chunk:
+                        break
+                    response += chunk
+            except socket.timeout:
+                pass
+        finally:
+            # Without this, a sendall()/recv() failure other than
+            # socket.timeout (e.g. ConnectionResetError/BrokenPipeError if
+            # the printer drops the connection mid-upload) skipped
+            # sock.close() entirely, leaking the fd on every failed attempt.
+            sock.close()
 
         # parse HTTP response body
         if b"\r\n\r\n" in response:
@@ -717,7 +868,7 @@ if __name__ == "__main__":
     parser.add_argument("--mode-id",   default=env_loader.MODE_ID)
     parser.add_argument("--device-id", default=env_loader.DEVICE_ID)
     parser.add_argument("--monitor",   action="store_true",
-                        help="Dauerhaft mithören und alle Reports ausgeben")
+                        help="Listen continuously and print all reports")
     args = parser.parse_args()
 
     client = KobraXClient(
@@ -741,7 +892,7 @@ if __name__ == "__main__":
 
         client.callbacks["*"] = on_msg
         client.connect()
-        print("[kobrax] Monitor-Modus aktiv (Ctrl-C zum Beenden)")
+        print("[kobrax] Monitor mode active (Ctrl-C to stop)")
         try:
             while True:
                 time.sleep(1)
@@ -755,7 +906,7 @@ if __name__ == "__main__":
         info = client.query_info()
         if info:
             d = info.get("data", {})
-            print(f"  Drucker:  {d.get('printerName')}  FW {d.get('version')}")
+            print(f"  Printer:  {d.get('printerName')}  FW {d.get('version')}")
             print(f"  Status:   {d.get('state')}")
             t = d.get("temp", {})
             print(f"  Nozzle:   {t.get('curr_nozzle_temp')}°C → {t.get('target_nozzle_temp')}°C")
@@ -764,6 +915,6 @@ if __name__ == "__main__":
             print(f"  Upload:   {urls.get('fileUploadurl')}")
             print(f"  Kamera:   {urls.get('rtspUrl')}")
         else:
-            print("  Keine Antwort")
+            print("  No response")
 
         client.disconnect()

orca_filaments.py

@@ -1,20 +1,23 @@
 """OrcaSlicer Filament-Profil Parser.
 
-Geteilt zwischen dem Generator (tools/gen_orca_filament_list.py) und dem
+Shared between the generator (tools/gen_orca_filament_list.py) and the
 Custom-Profile-Import-Endpoint (bridge/kobrax_moonraker_bridge.py).
 
-Liest Orca-Filament-JSON-Dateien (System- oder User-Profile) und gibt
-sie als normalisierte Liste mit (id, name, vendor, type, color) zurück.
+Reads Orca filament JSON files (system or user profiles) and returns
+them as a normalized list with (id, name, vendor, type, color).
 """
 from __future__ import annotations
 
 import json
+import logging
 import re
 
+log = logging.getLogger("kobrax.filaments")
+
 
 def first_str(value, default: str = "") -> str:
-    """Orca-Profile speichern manche Felder als ['wert']. Liefert erstes
-    Element als String."""
+    """Orca profiles store some fields as ['value']. Returns the first
+    element as a string."""
     if isinstance(value, list):
         return str(value[0]) if value else default
     if isinstance(value, str):
@@ -37,39 +40,49 @@ def parse_profile(data: dict, by_name: dict | None = None,
                   path_vendor: str | None = None,
                   source_path: str = "",
                   system_index: list | None = None) -> dict | None:
-    """Parsed ein einzelnes Orca-Filament-Profil zum Bridge-Schema.
+    """Parses a single Orca filament profile into the bridge schema.
 
-    `by_name` ist optional ein {name: [profile, …]}-Index für Inherits-Resolve
-    aus dem rohen Source-Tree (Generator). Bei Single-File-Import (User-Datei
-    aus OrcaSlicer-User-Dir) reichen wir stattdessen `system_index` rein —
-    die fertige System-Profile-Liste aus orca_filaments.json. Damit können
-    wir filament_id/vendor/type/color über die `inherits`-Kette aus dem
-    System-Parent ableiten, auch wenn das User-Profil diese Felder nicht
-    selbst setzt (typisch: User-Override-Profile haben nur Tweaks).
+    `by_name` is optionally a {name: [profile, ...]} index for inherits resolution
+    from the raw source tree (generator). For single-file imports (user file
+    from the OrcaSlicer user dir) we pass `system_index` instead -
+    the finished system profile list from orca_filaments.json. This lets
+    us derive filament_id/vendor/type/color via the `inherits` chain from
+    the system parent even when the user profile does not set these
+    fields itself (typically: user override profiles only contain tweaks).
 
-    Liefert {id, name, vendor, type, color} oder None wenn das Profil
-    keine filament_id hat (z.B. abstrakte @base-Templates).
+    Returns {id, name, vendor, type, color} or None when the profile
+    has no filament_id (e.g. abstract @base templates).
     """
     if not isinstance(data, dict):
         return None
-    # User-Profile aus dem OrcaSlicer-User-Dir setzen oft KEIN "type"-Feld —
-    # das kommt vom System-Parent. Wir akzeptieren das wenn entweder "type"
-    # explizit "filament" ist ODER ein "inherits" auf ein anderes Profil zeigt.
+    # User profiles from the OrcaSlicer user dir often set NO "type" field -
+    # it comes from the system parent. We accept that when either "type"
+    # is explicitly "filament" OR an "inherits" points to another profile.
     if data.get("type") not in (None, "filament") and not data.get("inherits"):
         return None
     if data.get("type") == "filament" and data.get("inherits") is None and not data.get("filament_id"):
-        # type=filament aber kein parent + keine ID → wertloses Stub
+        # type=filament but no parent + no ID -> worthless stub
         return None
     inst = data.get("instantiation", "true")
     if isinstance(inst, str) and inst.lower() == "false":
         return None
 
-    # Build system-name-Index für den fallback-Lookup wenn system_index gesetzt.
+    # Build the system name index for the fallback lookup when system_index is set.
     sys_by_name: dict[str, dict] = {}
     if system_index:
         for p in system_index:
             if isinstance(p, dict) and p.get("name"):
-                sys_by_name[p["name"]] = p
+                pname = p["name"]
+                if pname in sys_by_name and sys_by_name[pname] is not p:
+                    # clean_name() deliberately collapses variant-suffixed
+                    # names (e.g. "...@base" vs "...@Anycubic Kobra X 0.4
+                    # nozzle") onto the same cleaned name - expected, but the
+                    # last-write-wins overwrite here was previously silent,
+                    # making an unexpected inherits-parent resolution hard to
+                    # debug.
+                    log.debug("orca_filaments: duplicate system profile name %r - "
+                              "overwriting %r with %r", pname, sys_by_name[pname].get("id"), p.get("id"))
+                sys_by_name[pname] = p
 
     def _resolve(key: str, depth: int = 5):
         cur_list = [data]
@@ -92,7 +105,7 @@ def parse_profile(data: dict, by_name: dict | None = None,
         return None
 
     def _resolve_via_system_index(key: str):
-        """Inherits-Kette über system_index (clean_name-Match)."""
+        """Inherits chain via system_index (clean_name match)."""
         parent_raw = data.get("inherits")
         if not parent_raw or not sys_by_name:
             return None
@@ -100,7 +113,7 @@ def parse_profile(data: dict, by_name: dict | None = None,
         sys_p = sys_by_name.get(parent_clean)
         if not sys_p:
             return None
-        # System-JSON benutzt schon das normalisierte Schema
+        # The system JSON already uses the normalized schema
         mapping = {
             "filament_id":              "id",
             "filament_vendor":          "vendor",
@@ -119,7 +132,7 @@ def parse_profile(data: dict, by_name: dict | None = None,
     if not fid or not isinstance(fid, str):
         return None
 
-    name_raw = data.get("name", fid)
+    name_raw = first_str(data.get("name"), fid)
     name = clean_name(name_raw)
     vendor = first_str(_resolve_full("filament_vendor")) or (path_vendor or "Generic")
     ftype  = first_str(_resolve_full("filament_type"), "")
@@ -136,10 +149,10 @@ def parse_profile(data: dict, by_name: dict | None = None,
 
 def parse_profile_bytes(blob: bytes, source_name: str = "",
                         system_index: list | None = None) -> dict | None:
-    """Liest ein einzelnes Profil aus JSON-Bytes. Für File-Upload-Pfad.
-    `system_index` ist optional die fertige Liste aus orca_filaments.json —
-    wird für die Inherits-Resolve von User-Profilen genutzt die das volle
-    Schema vom System-Parent erben."""
+    """Reads a single profile from JSON bytes. For the file upload path.
+    `system_index` is optionally the finished list from orca_filaments.json -
+    used for the inherits resolution of user profiles that do not carry the full
+    schema from the system parent."""
     try:
         data = json.loads(blob.decode("utf-8", errors="replace"))
     except Exception:

start.sh

@@ -1,10 +1,12 @@
 #!/usr/bin/env bash
-# start.sh – KX-Bridge starten (baut Docker-Image automatisch wenn nötig)
+# start.sh – KX-Bridge starten (zieht das fertige Image aus der Registry)
 
 set -euo pipefail
 
 cd "$(dirname "$0")"
 
+IMAGE_BASE="gitea.it-drui.de/viewit/kx-bridge"
+
 # .env anlegen falls nicht vorhanden
 if [[ ! -f .env ]]; then
     if [[ -f .env.example ]]; then
@@ -30,38 +32,38 @@ if ! docker info > /dev/null 2>&1; then
     exit 1
 fi
 
-# Prüfen ob Build nötig ist
-NEEDS_BUILD=0
-if ! docker image inspect kx-bridge:latest > /dev/null 2>&1; then
-    echo "[start] Image nicht vorhanden – baue kx-bridge:latest ..."
-    NEEDS_BUILD=1
+# Release-Kanal abfragen
+CHANNEL=""
+if [[ "${1:-}" == "stable" || "${1:-}" == "nightly" ]]; then
+    CHANNEL="$1"
 else
-    # Image-Erstellungszeit in Unix-Sekunden
-    IMAGE_TS=$(docker inspect --format='{{.Created}}' kx-bridge:latest \
-        | python3 -c "import sys,datetime; s=sys.stdin.read().strip(); \
-          s=s[:26].rstrip('Z').replace('T',' '); \
-          print(int(datetime.datetime.fromisoformat(s).replace(tzinfo=datetime.timezone.utc).timestamp()))" 2>/dev/null || echo 0)
-
-    for f in Dockerfile \
-              bridge/kobrax_moonraker_bridge.py \
-              bridge/kobrax_client.py \
-              bridge/env_loader.py \
-              bridge/requirements.txt \
-              bridge/anycubic_slicer.crt \
-              bridge/anycubic_slicer.key; do
-        if [[ -f "$f" ]]; then
-            FILE_TS=$(python3 -c "import os; print(int(os.path.getmtime('$f')))" 2>/dev/null || echo 0)
-            if [[ $FILE_TS -gt $IMAGE_TS ]]; then
-                echo "[start] '$f' ist neuer als das Image – baue neu ..."
-                NEEDS_BUILD=1
-                break
-            fi
-        fi
-    done
+    echo ""
+    echo "  Welchen Release-Kanal möchtest du starten?"
+    echo "    1) stable   (empfohlen)"
+    echo "    2) nightly  (getestete Vorabversion)"
+    echo -n "  Auswahl [1]: "
+    read -r CHOICE
+    case "$CHOICE" in
+        2) CHANNEL="nightly" ;;
+        *) CHANNEL="stable" ;;
+    esac
 fi
 
-if [[ $NEEDS_BUILD -eq 1 ]]; then
-    docker build -t kx-bridge:latest .
+if [[ "$CHANNEL" == "nightly" ]]; then
+    IMAGE_TAG="nightly"
+else
+    IMAGE_TAG="latest"
+fi
+IMAGE="$IMAGE_BASE:$IMAGE_TAG"
+
+echo "[start] Kanal: $CHANNEL  →  Image: $IMAGE"
+echo "[start] Ziehe aktuelles Image ..."
+docker pull "$IMAGE"
+
+# docker-compose.yml auf den gewählten Kanal umschreiben (nur die image-Zeile)
+if [[ -f docker-compose.yml ]]; then
+    sed -i.bak -E "s#^(\s*image:\s*).*#\1$IMAGE#" docker-compose.yml
+    rm -f docker-compose.yml.bak
 fi
 
 # Container starten
@@ -70,7 +72,7 @@ docker-compose down 2>/dev/null || true
 docker-compose up -d
 
 echo ""
-echo "  ✓ KX-Bridge läuft"
+echo "  ✓ KX-Bridge läuft ($CHANNEL)"
 echo "  Web-UI : http://$(hostname -I | awk '{print $1}'):7125"
 echo "  Logs   : docker-compose logs -f"
 echo "  Stop   : docker-compose down"

tests/conftest.py

@@ -2,12 +2,13 @@
 Shared fixtures für KX-Bridge Tests.
 Startet die Bridge in-process mit einem Mock-MQTT-Client (kein Drucker nötig).
 """
-import sys, types, argparse, pytest, pytest_asyncio
+import sys, types, argparse, tempfile, pytest, pytest_asyncio
 from unittest.mock import MagicMock
 from aiohttp.test_utils import TestClient, TestServer
 
 # ── Pfad ──────────────────────────────────────────────────────────────────────
-sys.path.insert(0, str(__import__("pathlib").Path(__file__).parent.parent / "bridge"))
+# Flat repo layout (no bridge/ subfolder anymore) — point at the repo root.
+sys.path.insert(0, str(__import__("pathlib").Path(__file__).parent.parent))
 
 # ── env_loader mocken (keine .env nötig) ──────────────────────────────────────
 env_mod = types.ModuleType("env_loader")
@@ -41,6 +42,7 @@ def make_args(**overrides):
         device_id   = "",
         host        = "127.0.0.1",
         port        = 7125,
+        data_dir    = tempfile.mkdtemp(prefix="kxtest-"),
     )
     for k, v in overrides.items():
         setattr(args, k, v)

tests/test_ace_rfid_vendor_matching.py

@@ -0,0 +1,236 @@
+"""Auto-matching for custom ACE-RFID filament tags (Issue #101).
+
+Anycubic's ACE RFID system concatenates vendor + material + a truncated
+serial into one `type` string for custom (third-party) tags, e.g.
+"GEEETECH PLA Bas" (vendor "Geeetech", material "PLA", serial "Bas" for
+"Basic"). Previously the bridge treated this whole string as an unknown
+material and fell back to a neutral "Generic <type>" profile, even though
+the user had already imported a matching OrcaSlicer profile via the ZIP
+import feature (Issue #41) - requiring a manual per-slot reassignment every
+time that spool was loaded.
+
+_parse_combined_rfid_type() + _match_profile_by_vendor_family() resolve this
+automatically against the merged system+user filament library.
+"""
+import argparse
+import tempfile
+from unittest.mock import MagicMock
+
+from kobrax_moonraker_bridge import KobraXBridge
+
+USER_PROFILES = [
+    {"id": "OGFL99", "name": "Generic PLA", "vendor": "Generic", "type": "PLA", "color": ""},
+    {"id": "GTPLA01", "name": "Geeetech PLA Basic", "vendor": "Geeetech", "type": "PLA", "color": "", "is_user": True},
+]
+
+
+def _bridge(profiles=USER_PROFILES):
+    c = MagicMock(); c.callbacks = {}; c.connected = False
+    args = argparse.Namespace(
+        printer_ip="", mqtt_port=9883, username="", password="",
+        mode_id="20030", device_id="", host="127.0.0.1", port=7125,
+        data_dir=tempfile.mkdtemp(prefix="kxrfid-"),
+    )
+    b = KobraXBridge(c, args=args)
+    b._orca_filaments_cache = profiles
+    return b
+
+
+def test_combined_rfid_type_parses_known_vendor_and_family():
+    b = _bridge()
+    vendor, family = b._parse_combined_rfid_type("GEEETECH PLA Bas")
+    assert vendor == "Geeetech"
+    assert family == "PLA"
+
+
+def test_plain_type_string_is_unaffected():
+    """Regression guard: a normal type="PLA" report (no vendor prefix) must
+    not be mistaken for a combined RFID string."""
+    b = _bridge()
+    vendor, family = b._parse_combined_rfid_type("PLA")
+    assert vendor == ""
+    assert family == ""
+
+
+def test_unknown_vendor_prefix_returns_no_match():
+    b = _bridge()
+    vendor, family = b._parse_combined_rfid_type("TOTALLYUNKNOWNBRAND PLA Bas")
+    assert vendor == ""
+    assert family == ""
+
+
+def test_match_profile_by_vendor_family_finds_imported_profile():
+    b = _bridge()
+    profile = b._match_profile_by_vendor_family("Geeetech", "PLA")
+    assert profile.get("name") == "Geeetech PLA Basic"
+
+
+def test_match_profile_by_vendor_family_no_match_returns_empty():
+    b = _bridge()
+    profile = b._match_profile_by_vendor_family("Geeetech", "PETG")
+    assert profile == {}
+
+
+def test_match_profile_by_vendor_family_ambiguous_picks_first_without_crashing():
+    profiles = USER_PROFILES + [
+        {"id": "GTPLA02", "name": "Geeetech PLA Silk", "vendor": "Geeetech", "type": "PLA SILK", "color": "", "is_user": True},
+    ]
+    b = _bridge(profiles)
+    profile = b._match_profile_by_vendor_family("Geeetech", "PLA")
+    assert profile.get("name") in ("Geeetech PLA Basic", "Geeetech PLA Silk")
+
+
+def test_build_lane_data_auto_resolves_combined_rfid_slot():
+    """End-to-end: a slot reporting the combined RFID string should surface
+    the imported Geeetech profile in lane_data instead of the Generic
+    fallback."""
+    b = _bridge()
+    b._filament_profiles = {}  # no manual per-slot override - isolate the auto-match path
+    b._filament_mode = "ace_hub"
+    b._ams_slots = [
+        {"global_index": 0, "box_id": 0, "status": 5, "type": "GEEETECH PLA Bas", "color": [238, 190, 152]},
+    ]
+    lane = b._build_lane_data()
+    tray = lane["ams"][0]["tray"][0]
+    assert tray["vendor_name"] == "Geeetech"
+    assert tray["name"] == "Geeetech PLA Basic"
+
+
+def test_build_lane_data_plain_type_still_uses_generic_fallback():
+    """Regression guard: everyday type="PLA" slots must keep using the
+    existing Generic-library fallback, unaffected by the new matching path."""
+    b = _bridge()
+    b._filament_profiles = {}  # no manual per-slot override - isolate the fallback path
+    b._filament_mode = "ace_hub"
+    b._ams_slots = [
+        {"global_index": 0, "box_id": 0, "status": 5, "type": "PLA", "color": [255, 255, 255]},
+    ]
+    lane = b._build_lane_data()
+    tray = lane["ams"][0]["tray"][0]
+    assert tray["name"] == "Generic PLA"
+    assert tray["vendor_name"] == "Generic"
+
+
+# ─── Centralized matching via _effective_slot_profile() ────────────────────
+#
+# The bug reported in Issue #101 by @Blaim (nightly45 not working, despite
+# _parse_combined_rfid_type()/_match_profile_by_vendor_family() existing):
+# those two helpers were ONLY ever invoked inside _build_lane_data(), which
+# is only reached when OrcaSlicer polls the Moonraker lane_data endpoint -
+# never as part of the real MQTT receive path (_on_multicolor_box ->
+# self._ams_slots -> _push_status_update -> dashboard / /kx/filament/slots).
+# So the dashboard and the Happy-Hare gate data never saw a match, matching
+# exactly what the user's screenshots showed. Fixed by moving the matching
+# logic into _effective_slot_profile() itself, which all three consumers
+# already call.
+
+def test_effective_slot_profile_auto_resolves_raw_rfid_string_without_override():
+    """The core Issue #101 regression: _effective_slot_profile() itself (not
+    just _build_lane_data()) must resolve a combined RFID string when there is
+    no manual per-slot override in config.ini."""
+    b = _bridge()
+    b._filament_profiles = {}
+    profile = b._effective_slot_profile(0, "GEEETECH PLA Bas")
+    assert profile.get("name") == "Geeetech PLA Basic"
+    assert profile.get("vendor") == "Geeetech"
+
+
+def test_effective_slot_profile_manual_override_still_wins():
+    b = _bridge()
+    b._filament_profiles = {0: {"id": "OGFL99", "name": "Generic PLA", "vendor": "Generic"}}
+    profile = b._effective_slot_profile(0, "GEEETECH PLA Bas")
+    assert profile.get("name") == "Generic PLA"
+
+
+def test_effective_slot_profile_plain_type_no_override_returns_empty():
+    """Regression guard: a plain type="PLA" slot with no override must still
+    fall through to {} (the caller's own generic-name fallback), not be
+    treated as an RFID string."""
+    b = _bridge()
+    b._filament_profiles = {}
+    assert b._effective_slot_profile(0, "PLA") == {}
+
+
+def _multicolor_box_report(raw_type: str, color=(238, 190, 152)) -> dict:
+    """A realistic multiColorBox/report payload for one ACE box (id=0) with
+    a toolhead (id=-1), matching the real Kobra X topology captured live
+    during Issue #100/#101 investigation - drives _detect_filament_mode()
+    to "ace_hub", same as on real hardware."""
+    return {
+        "state": "success",
+        "data": {
+            "head_tools_model": 1,
+            "multi_color_box": [
+                {
+                    "id": -1, "loaded_slot": -1,
+                    "slots": [{"index": 0, "status": 0, "type": "", "color": [0, 0, 0]}],
+                },
+                {
+                    "id": 0, "loaded_slot": -1,
+                    "slots": [
+                        {"index": 0, "status": 0, "type": "", "color": [0, 0, 0]},
+                        {"index": 1, "status": 0, "type": "", "color": [0, 0, 0]},
+                        {
+                            "index": 2, "status": 5, "type": raw_type,
+                            "color": list(color), "sku": "",
+                        },
+                        {"index": 3, "status": 0, "type": "", "color": [0, 0, 0]},
+                    ],
+                },
+            ],
+        },
+    }
+
+
+def test_on_multicolor_box_end_to_end_resolves_rfid_slot_for_dashboard():
+    """End-to-end regression test for Issue #101: feed a raw MQTT
+    multiColorBox/report payload through the real receive path
+    (_on_multicolor_box), then check that the dashboard-facing
+    /kx/filament/slots data (handle_kx_filament_slots) - which is what
+    populates the dashboard's window._slotProfileMap in the browser -
+    actually reflects the matched profile, not the raw "GEEETECH PLA Bas"
+    string. This is the exact path that was broken and untested before."""
+    b = _bridge()
+    b._filament_profiles = {}
+    b._on_multicolor_box(_multicolor_box_report("GEEETECH PLA Bas"))
+
+    assert b._filament_mode == "ace_hub"
+    # global_index 6 = box_id 0 * 4 + local slot 2 in ace_hub mode's ACE block
+    slot = next(s for s in b._ams_slots if s.get("type") == "GEEETECH PLA Bas")
+    global_idx = slot["global_index"]
+
+    profile = b._effective_slot_profile(global_idx, slot["type"])
+    assert profile.get("name") == "Geeetech PLA Basic"
+    assert profile.get("vendor") == "Geeetech"
+
+
+def test_match_profile_by_vendor_family_disambiguates_via_variant_tokens():
+    """Issue #101 follow-up (@Blaim): two profiles of the same vendor+family
+    ("Geeetech PLA Basic" vs. "Geeetech PLA Matte") must resolve to the one
+    matching the RFID string's truncated variant token ("bas" -> Basic),
+    not just "whichever loads first"."""
+    profiles = USER_PROFILES + [
+        {"id": "GTPLA03", "name": "Geeetech PLA Matte", "vendor": "Geeetech", "type": "PLA", "color": "", "is_user": True},
+    ]
+    b = _bridge(profiles)
+
+    basic = b._match_profile_by_vendor_family("Geeetech", "PLA", ["bas"])
+    assert basic.get("name") == "Geeetech PLA Basic"
+
+    matte = b._match_profile_by_vendor_family("Geeetech", "PLA", ["mat"])
+    assert matte.get("name") == "Geeetech PLA Matte"
+
+
+def test_match_profile_by_vendor_family_no_variant_tokens_falls_back_to_first():
+    profiles = USER_PROFILES + [
+        {"id": "GTPLA03", "name": "Geeetech PLA Matte", "vendor": "Geeetech", "type": "PLA", "color": "", "is_user": True},
+    ]
+    b = _bridge(profiles)
+    profile = b._match_profile_by_vendor_family("Geeetech", "PLA")
+    assert profile.get("name") == "Geeetech PLA Basic"
+
+
+def test_rfid_variant_tokens_extracts_tokens_after_vendor_and_family():
+    assert KobraXBridge._rfid_variant_tokens("GEEETECH PLA Bas") == ["bas"]
+    assert KobraXBridge._rfid_variant_tokens("GEEETECH PLA") == []
+    assert KobraXBridge._rfid_variant_tokens("PLA") == []

tests/test_auto_ams_box_mapping_empty_slot.py

@@ -0,0 +1,85 @@
+"""Empty-tray placeholder bug in the OrcaSlicer "upload and print" path.
+
+Real KX1 bug (confirmed 2026-07-22): printing Filament 4 with the slot below it
+EMPTY fails; with all slots full it works. `_start_print` -> `_build_auto_ams_box_mapping`
+inserts a positional placeholder at each gap whose `ams_index` points at the
+gap's own (physically EMPTY) tray. The printer rejects a mapping entry that
+references an empty tray, even for a tool the GCode never calls.
+
+Invariant the fix must hold: EVERY entry's ams_index references a LOADED tray.
+Positional alignment (entry N = TN, from a16062f) must be preserved.
+"""
+import argparse
+import tempfile
+from unittest.mock import MagicMock
+
+from kobrax_moonraker_bridge import KobraXBridge
+
+# Real KX1 AMS state: slot 2 (idx 2) EMPTY, below the used Filament 4 (idx 3).
+AMS_SLOTS = [
+    {"global_index": 0, "box_id": -1, "status": 5, "type": "PLA",      "color": [101, 88, 177]},
+    {"global_index": 1, "box_id": -1, "status": 5, "type": "PLA SILK", "color": [239, 96, 163]},
+    {"global_index": 2, "box_id": -1, "status": 4, "type": "PLA",      "color": [223, 221, 220]},  # EMPTY
+    {"global_index": 3, "box_id": -1, "status": 5, "type": "PLA",      "color": [117, 120, 123]},
+]
+
+
+def _bridge(slots=AMS_SLOTS):
+    c = MagicMock(); c.callbacks = {}; c.connected = False
+    args = argparse.Namespace(
+        printer_ip="", mqtt_port=9883, username="", password="",
+        mode_id="20030", device_id="", host="127.0.0.1", port=7125,
+        data_dir=tempfile.mkdtemp(prefix="kxauto-"),
+    )
+    b = KobraXBridge(c, args=args)
+    b._filament_mode = "toolhead"
+    b._ams_slots = [dict(s) for s in slots]
+    return b
+
+
+def _loaded_ams_indices(b):
+    return {b._slot_to_print_ams_index(int(s["global_index"]))
+            for s in b._ams_slots if s["status"] == 5}
+
+
+def test_no_entry_points_at_an_empty_tray_when_only_used_slot_loaded():
+    """_start_print filters loaded to the used slot only: loaded=[(3, slot3)].
+    Positions 0..2 are placeholders and must NOT reference empty tray idx 2."""
+    b = _bridge()
+    loaded = [(3, b._ams_slots[3])]
+
+    mapping = b._build_auto_ams_box_mapping(loaded_slots=loaded)
+
+    assert [e["paint_index"] for e in mapping] == [0, 1, 2, 3]  # positional alignment kept
+    loaded_ams = _loaded_ams_indices(b)
+    bad = [e for e in mapping if e["ams_index"] not in loaded_ams]
+    assert not bad, f"entries reference an empty/non-loaded tray: {bad}"
+
+
+def test_no_entry_points_at_an_empty_tray_with_gap_in_loaded_set():
+    """All occupied slots mapped (0,1,3 loaded, 2 empty). The placeholder at
+    position 2 must not reference the empty tray idx 2."""
+    b = _bridge()
+    loaded = [(0, b._ams_slots[0]), (1, b._ams_slots[1]), (3, b._ams_slots[3])]
+
+    mapping = b._build_auto_ams_box_mapping(loaded_slots=loaded)
+
+    assert [e["paint_index"] for e in mapping] == [0, 1, 2, 3]
+    loaded_ams = _loaded_ams_indices(b)
+    bad = [e for e in mapping if e["ams_index"] not in loaded_ams]
+    assert not bad, f"entries reference an empty/non-loaded tray: {bad}"
+    # Real loaded slots keep their own ams_index.
+    assert mapping[0]["ams_index"] == 0
+    assert mapping[1]["ams_index"] == 1
+    assert mapping[3]["ams_index"] == 3
+
+
+def test_all_full_is_unchanged():
+    """All slots loaded -> no placeholders, identity mapping (the working case)."""
+    slots = [dict(s, status=5) for s in AMS_SLOTS]
+    b = _bridge(slots)
+    loaded = [(i, b._ams_slots[i]) for i in range(4)]
+
+    mapping = b._build_auto_ams_box_mapping(loaded_slots=loaded)
+
+    assert [e["ams_index"] for e in mapping] == [0, 1, 2, 3]

tests/test_buried_report.py

@@ -0,0 +1,111 @@
+"""
+Tests für buried/report — das druckerseitige Analytics-Event, das einmal pro
+Druckstart feuert (verifiziert live gegen einen echten Kobra X, sowohl für
+Anycubic Slicer Next als auch für OrcaSlicer/die Bridge selbst). Liefert
+gcode_size/estimate_duration/total_layers, die server/files/metadata für
+Dateien außerhalb des eigenen GCodeStore sonst nicht hat (Issue #102).
+"""
+import pytest
+
+
+BURIED_PAYLOAD = {
+    "type": "buried",
+    "action": "PrintStart",
+    "code": 200,
+    "state": "done",
+    "data": {
+        "task_name": "Smileys_simple_plate(01)_PLA_0.2_16m39s.gcode",
+        "gcode_size": 644437,
+        "estimate_duration": 1264,
+        "total_layers": 8,
+        "storage_total": 6481,
+        "storage_used": 898,
+        "slicer": "OrcaSlicer",
+    },
+}
+
+
+def test_on_buried_populates_cache(client):
+    _, bridge = client
+    bridge._on_buried(BURIED_PAYLOAD)
+    assert bridge._buried_cache == {
+        "task_name": "Smileys_simple_plate(01)_PLA_0.2_16m39s.gcode",
+        "gcode_size": 644437,
+        "estimate_duration": 1264,
+        "total_layers": 8,
+    }
+
+
+def test_on_buried_populates_storage_state(client):
+    _, bridge = client
+    bridge._on_buried(BURIED_PAYLOAD)
+    assert bridge._state["storage_total_mb"] == 6481
+    assert bridge._state["storage_used_mb"] == 898
+
+
+def test_on_buried_ignores_payload_without_task_name(client):
+    _, bridge = client
+    bridge._buried_cache = None
+    bridge._on_buried({"type": "buried", "data": {"gcode_size": 123}})
+    assert bridge._buried_cache is None
+
+
+def test_build_file_metadata_uses_buried_fallback_for_unknown_file(client):
+    """A file not in the GCodeStore and not the currently-tracked job should
+    still get real size/estimated_time/layer_count from the buried cache."""
+    _, bridge = client
+    bridge._on_buried(BURIED_PAYLOAD)
+    meta = bridge._build_file_metadata("Smileys_simple_plate(01)_PLA_0.2_16m39s.gcode")
+    assert meta["size"] == 644437
+    assert meta["estimated_time"] == 1264
+    assert meta["layer_count"] == 8
+
+
+def test_build_file_metadata_ignores_buried_cache_for_different_file(client):
+    """The buried cache must only apply when task_name matches the queried
+    filename - otherwise it would leak the last print's data into an
+    unrelated query, the exact bug Issue #102 already fixed for live state."""
+    _, bridge = client
+    bridge._on_buried(BURIED_PAYLOAD)
+    meta = bridge._build_file_metadata("some_other_file.gcode")
+    assert meta["size"] == 1  # unchanged fallback, not leaked from buried cache
+    assert meta["estimated_time"] is None
+    assert meta["layer_count"] is None
+
+
+def test_build_file_metadata_prefers_gcodestore_over_buried(client):
+    """GCodeStore data (from the bridge's own upload) must win over the
+    buried cache when both are available for the same filename."""
+    _, bridge = client
+    bridge._on_buried(BURIED_PAYLOAD)
+    with bridge._store._lock:
+        bridge._store._conn.execute(
+            "INSERT INTO gcode_files (id, filename, path, size_bytes, uploaded_at, layer_count, est_print_time_sec) "
+            "VALUES (?,?,?,?,?,?,?)",
+            ("f1", "Smileys_simple_plate(01)_PLA_0.2_16m39s.gcode", "/tmp/f1", 999999, "2026-01-01T00:00:00Z", 42, 5000),
+        )
+        bridge._store._conn.commit()
+    meta = bridge._build_file_metadata("Smileys_simple_plate(01)_PLA_0.2_16m39s.gcode")
+    assert meta["size"] == 999999
+    assert meta["estimated_time"] == 5000
+    assert meta["layer_count"] == 42
+
+
+@pytest.mark.asyncio
+async def test_api_state_reports_storage_after_buried_report(client):
+    c, bridge = client
+    bridge._on_buried(BURIED_PAYLOAD)
+    resp = await c.get("/api/state")
+    assert resp.status == 200
+    data = await resp.json()
+    assert data["storage_total_mb"] == 6481
+    assert data["storage_used_mb"] == 898
+
+
+@pytest.mark.asyncio
+async def test_api_state_storage_defaults_to_zero(client):
+    c, _ = client
+    resp = await c.get("/api/state")
+    data = await resp.json()
+    assert data["storage_total_mb"] == 0
+    assert data["storage_used_mb"] == 0

tests/test_camera_cache_url_rotation.py

@@ -0,0 +1,51 @@
+"""Camera stream hangs forever after printer reboot (Issue #99).
+
+The printer rotates its stream token on reboot, changing the camera URL.
+CameraCache.set_url() used to be a bare assignment - the running ffmpeg loops
+never noticed since they only re-read self._url at the top of their outer
+loop, which they never reach while permanently blocked reading stdout from
+the now-silent, stale-token connection. set_url() must detect the change and
+tear the loops down so the next ensure_running() respawns them against the
+new URL.
+"""
+from kobrax_moonraker_bridge import CameraCache
+
+
+def test_set_url_first_time_does_not_reset():
+    """No prior URL - nothing stale to tear down."""
+    c = CameraCache()
+    calls = []
+    c.reset = lambda: calls.append(True)
+    c.set_url("http://printer/live/tokenA")
+    assert c._url == "http://printer/live/tokenA"
+    assert not calls
+
+
+def test_set_url_same_value_does_not_reset():
+    c = CameraCache()
+    calls = []
+    c.set_url("http://printer/live/tokenA")
+    c.reset = lambda: calls.append(True)
+    c.set_url("http://printer/live/tokenA")
+    assert not calls
+
+
+def test_set_url_changed_triggers_reset():
+    """The actual bug scenario: token rotates after a printer reboot."""
+    c = CameraCache()
+    calls = []
+    c.set_url("http://printer/live/tokenA")
+    c.reset = lambda: calls.append(True)
+    c.set_url("http://printer/live/tokenB")
+    assert c._url == "http://printer/live/tokenB"
+    assert calls == [True]
+
+
+def test_set_url_empty_to_value_does_not_reset():
+    """Startup case: no URL known yet, first status push sets it - nothing
+    running to tear down."""
+    c = CameraCache()
+    calls = []
+    c.reset = lambda: calls.append(True)
+    c.set_url("http://printer/live/tokenA")
+    assert not calls

tests/test_camera_process_race.py

@@ -0,0 +1,83 @@
+"""Camera ffmpeg process-handle race (code review finding).
+
+_run_jpeg_loop()/_run_h264_loop() used to operate on the shared instance
+attribute (self._proc_jpeg / self._proc_h264) in their cleanup, instead of a
+local reference to the process they themselves started - the same bug
+_run_mjpeg_loop() already had fixed with a documented local-`proc` pattern.
+
+If a loop's task is cancelled (e.g. via CameraCache.reset() after a stream
+URL rotation) while a new task has already started and assigned its own
+process to the shared attribute, the cancelled task's cleanup would kill
+and null out the NEWER process instead of its own - leaking its own actual
+ffmpeg child as an orphan that nothing ever cleans up again.
+"""
+import asyncio
+from unittest.mock import AsyncMock, MagicMock, patch
+
+import pytest
+
+from kobrax_moonraker_bridge import CameraCache
+
+
+def _fake_proc(name):
+    """A minimal stand-in for asyncio.subprocess.Process good enough to
+    drive _run_jpeg_loop()'s read/kill/wait/returncode usage."""
+    proc = MagicMock(name=name)
+    proc.returncode = 0
+    proc.kill = MagicMock()
+    proc.wait = AsyncMock()
+    proc.stdout = MagicMock()
+    proc.stderr = MagicMock()
+    proc.stderr.read = AsyncMock(return_value=b"")
+    return proc
+
+
+@pytest.mark.asyncio
+async def test_jpeg_loop_cleanup_does_not_kill_a_newer_process():
+    cache = CameraCache()
+    cache._url = "http://printer/live/streamtoken"
+
+    old_proc = _fake_proc("old")
+    new_proc = _fake_proc("new")
+
+    # old_proc's stdout.read blocks forever until cancelled - simulating the
+    # loop being stuck reading from a stale connection, same as the real bug.
+    stuck = asyncio.Event()
+
+    async def old_stdout_read(_n):
+        await stuck.wait()
+        return b""
+
+    old_proc.stdout.read = old_stdout_read
+
+    create_calls = []
+
+    async def fake_create_subprocess_exec(*args, **kwargs):
+        create_calls.append(1)
+        return old_proc if len(create_calls) == 1 else new_proc
+
+    with patch("kobrax_moonraker_bridge.asyncio.create_subprocess_exec",
+               side_effect=fake_create_subprocess_exec), \
+         patch("kobrax_moonraker_bridge._find_ffmpeg", return_value="ffmpeg"):
+        task = asyncio.create_task(cache._run_jpeg_loop())
+        # Let the loop start and assign old_proc to the shared attribute.
+        await asyncio.sleep(0.05)
+        assert cache._proc_jpeg is old_proc
+
+        # Simulate a second loop iteration's process already having been
+        # assigned to the shared attribute before the cancelled task's
+        # cleanup runs - the exact race window from the bug report.
+        cache._proc_jpeg = new_proc
+
+        task.cancel()
+        try:
+            await asyncio.wait_for(task, timeout=2.0)
+        except (asyncio.CancelledError, asyncio.TimeoutError):
+            pass
+
+    # The cancelled task must have killed/waited on ITS OWN process (old_proc),
+    # not the newer one that had already taken over the shared attribute.
+    old_proc.kill.assert_called_once()
+    new_proc.kill.assert_not_called()
+    # And it must not have clobbered the newer process's slot.
+    assert cache._proc_jpeg is new_proc

tests/test_client_robustness.py

@@ -0,0 +1,189 @@
+"""Robustness fixes found during a targeted code review of kobrax_client.py:
+
+1. _drain()/_dispatch() must not get stuck reprocessing the same malformed
+   packet forever when the printer sends valid JSON that isn't an object
+   (e.g. a bare number or list) - previously an exception from _dispatch()
+   escaped before self._buf was advanced, so the same bytes sat at the
+   front of the buffer and crashed every subsequent _drain() call, each one
+   forcing a reconnect via the reader loop's exception handler.
+2. publish()'s pending-dict registration/cleanup must be safe against
+   concurrent callers for the same msg_type, and a stale/late reply must
+   not be delivered to a newer, unrelated caller waiting on the same
+   report-topic suffix.
+3. upload_gcode() must raise a clear error for a malformed upload URL
+   (missing "?s=") instead of silently sending an unauthenticated request,
+   and must not leak the upload socket on a send/recv failure.
+"""
+import argparse
+import json
+import socket
+import tempfile
+import threading
+import time
+from unittest.mock import MagicMock, patch
+
+import pytest
+
+from kobrax_client import KobraXClient, _build_publish
+
+
+def _client(**overrides):
+    kwargs = dict(
+        host="192.168.1.100", username="u", password="p",
+        mode_id="20030", device_id="abc123", port=9883,
+        client_id="test",
+    )
+    kwargs.update(overrides)
+    return KobraXClient(**kwargs)
+
+
+def _frame(topic: str, payload) -> bytes:
+    """Builds a raw MQTT PUBLISH frame carrying `payload` as JSON, the same
+    wire format _drain() parses."""
+    return _build_publish(topic, json.dumps(payload))
+
+
+# --- Fix 1: malformed (non-dict) JSON payload must not wedge the buffer ---
+
+def test_drain_advances_buffer_past_non_dict_payload():
+    c = _client()
+    # A bare JSON number is valid JSON but not a dict - json.loads succeeds,
+    # but _dispatch()'s dict-oriented logic would previously crash on it.
+    bad = _frame("anycubic/anycubicCloud/v1/printer/public/20030/abc123/info/report", 42)
+    good = _frame("anycubic/anycubicCloud/v1/printer/public/20030/abc123/info/report", {"state": "done"})
+    c._buf = bad + good
+
+    c._drain()  # must not raise
+
+    # Both packets must have been consumed - the malformed one logged/skipped,
+    # the buffer advanced past it so the following valid packet is also
+    # processed, not left stuck behind it.
+    assert c._buf == b""
+
+
+def test_drain_does_not_reprocess_bad_packet_on_repeated_calls():
+    """Regression guard for the original bug: before the fix, a crash in
+    _dispatch() left self._buf untouched, so the bad packet stayed at the
+    front and every _drain() call re-crashed on it."""
+    c = _client()
+    bad = _frame("anycubic/anycubicCloud/v1/printer/public/20030/abc123/info/report", [1, 2, 3])
+    c._buf = bad
+
+    c._drain()
+    assert c._buf == b""  # consumed, not stuck
+
+    # A second call on the now-empty buffer must be a no-op, not a re-crash.
+    c._drain()
+    assert c._buf == b""
+
+
+def test_dispatch_rejects_non_dict_payload_directly():
+    c = _client()
+    c._dispatch("anycubic/anycubicCloud/v1/printer/public/20030/abc123/info/report", "not a dict")
+    # No exception, no registered pending entries get corrupted.
+    assert c._pending_report == {}
+
+
+# --- Fix 2: pending-dict thread-safety + msgid correlation ---
+
+def test_publish_concurrent_same_msg_type_both_get_delivered():
+    """Two overlapping publish() calls for the same msg_type must each
+    receive their OWN reply, not have one silently miss out because the
+    other already claimed the shared report_key slot."""
+    c = _client()
+    c._running = True
+    c._sock = MagicMock()
+    c._ensure_reader = lambda: None  # no real reader thread needed for this test
+
+    results = {}
+
+    def call(label):
+        results[label] = c.publish("info", "query", timeout=2.0)
+
+    t1 = threading.Thread(target=call, args=("a",))
+    t2 = threading.Thread(target=call, args=("b",))
+    t1.start()
+    time.sleep(0.02)
+    t2.start()
+    time.sleep(0.05)
+
+    # Simulate the printer replying to whichever msgid-bearing requests are
+    # currently pending, by msgid (the reliable path both requests can use).
+    with c._pending_lock:
+        pending = dict(c._pending_msgid)
+    for msgid, entry in pending.items():
+        c._dispatch("anycubic/anycubicCloud/v1/printer/public/20030/abc123/info/report",
+                    {"msgid": msgid, "state": "done", "data": {"ok": True}})
+
+    t1.join(timeout=3)
+    t2.join(timeout=3)
+
+    assert results["a"] is not None
+    assert results["b"] is not None
+
+
+def test_dispatch_ignores_stale_reply_with_mismatched_msgid():
+    """A late reply carrying a msgid that doesn't match what the current
+    report_key waiter is expecting must not be delivered to it - it belongs
+    to an earlier, already-resolved/timed-out request."""
+    c = _client()
+    c._running = True
+    c._sock = MagicMock()
+
+    event = threading.Event()
+    entry = {"event": event, "result": None, "msgid": "the-real-one"}
+    with c._pending_lock:
+        c._pending_report["info/report"] = entry
+
+    # A stale reply for a different msgid must not resolve this waiter.
+    c._dispatch("anycubic/anycubicCloud/v1/printer/public/20030/abc123/info/report",
+                {"msgid": "some-other-stale-id", "state": "done"})
+    assert not event.is_set()
+    assert entry["result"] is None
+
+    # The matching reply must resolve it.
+    c._dispatch("anycubic/anycubicCloud/v1/printer/public/20030/abc123/info/report",
+                {"msgid": "the-real-one", "state": "done"})
+    assert event.is_set()
+    assert entry["result"]["msgid"] == "the-real-one"
+
+
+def test_dispatch_delivers_reply_without_msgid_as_before():
+    """Regression guard: plenty of printer reports carry no msgid at all
+    (e.g. spontaneous status pushes) - those must still resolve a waiter
+    registered without one (entry["msgid"] is falsy)."""
+    c = _client()
+    event = threading.Event()
+    entry = {"event": event, "result": None, "msgid": None}
+    with c._pending_lock:
+        c._pending_report["info/report"] = entry
+
+    c._dispatch("anycubic/anycubicCloud/v1/printer/public/20030/abc123/info/report",
+                {"state": "done"})
+    assert event.is_set()
+
+
+# --- Fix 3: upload_gcode() URL validation + socket cleanup ---
+
+def test_upload_gcode_raises_clear_error_on_missing_session_token(tmp_path):
+    c = _client()
+    f = tmp_path / "test.gcode"
+    f.write_text("; gcode")
+
+    with pytest.raises(RuntimeError, match="session token"):
+        c.upload_gcode(str(f), upload_url="http://192.168.1.100:18910/gcode_upload")
+
+
+def test_upload_gcode_closes_socket_on_send_failure(tmp_path):
+    c = _client()
+    f = tmp_path / "test.gcode"
+    f.write_text("; gcode")
+
+    fake_sock = MagicMock()
+    fake_sock.sendall.side_effect = ConnectionResetError("printer went away")
+
+    with patch("socket.create_connection", return_value=fake_sock):
+        with pytest.raises(ConnectionResetError):
+            c.upload_gcode(str(f), upload_url="http://192.168.1.100:18910/gcode_upload?s=tok123")
+
+    fake_sock.close.assert_called_once()

tests/test_config_loader_robustness.py

@@ -0,0 +1,66 @@
+"""config_loader.py robustness fixes found during code review:
+
+1. _safe_int() must fall back to a default instead of raising - the
+   module-level numeric shortcuts (MQTT_PORT, POLL_INTERVAL, etc.) run this
+   at import time, so an uncaught ValueError there previously crashed the
+   entire bridge on startup if config.ini had a typo'd numeric value
+   (e.g. "mqtt_port = 98833x"), with a raw traceback instead of a clear
+   diagnostic. list_printers() already guarded this same class of input the
+   same way; this applies it to the module-level shortcuts too.
+2. migrate_env_to_config() must log a clear error (not a bare traceback)
+   if writing the migrated config.ini fails (e.g. permission error).
+"""
+import subprocess
+import sys
+import textwrap
+
+import config_loader
+
+
+def test_safe_int_returns_value_for_valid_numeric_string():
+    assert config_loader._safe_int("42", 0) == 42
+
+
+def test_safe_int_falls_back_to_default_on_garbage():
+    assert config_loader._safe_int("98833x", 9883) == 9883
+
+
+def test_safe_int_falls_back_to_default_on_empty_string():
+    assert config_loader._safe_int("", 3) == 3
+
+
+def test_safe_int_falls_back_to_default_on_none():
+    assert config_loader._safe_int(None, 5) == 5
+
+
+def test_config_loader_import_survives_malformed_config_ini(tmp_path):
+    """End-to-end regression guard: importing config_loader with a
+    config.ini containing a non-numeric mqtt_port must not raise - it must
+    fall back to the default instead. Run in a subprocess since
+    config_loader executes its migration/loading logic at import time and
+    Python caches modules, so a plain re-import in this test process
+    wouldn't actually re-exercise the import-time code path."""
+    config_dir = tmp_path / "config"
+    config_dir.mkdir()
+    (config_dir / "config.ini").write_text(
+        "[connection]\n"
+        "printer_ip = 192.168.1.50\n"
+        "mqtt_port = 98833x\n"  # malformed - not a number
+    )
+
+    script = textwrap.dedent(f"""
+        import sys
+        sys.path.insert(0, {str(tmp_path.parent.parent)!r})
+        import config_loader
+        config_loader._BASE = __import__("pathlib").Path({str(tmp_path)!r})
+        config_loader._find_config_file = lambda: {str(config_dir / "config.ini")!r} \
+            and __import__("pathlib").Path({str(config_dir / "config.ini")!r})
+        import importlib
+        importlib.reload(config_loader)
+        assert config_loader.MQTT_PORT == 9883, config_loader.MQTT_PORT
+        print("OK")
+    """)
+
+    result = subprocess.run([sys.executable, "-c", script], capture_output=True, text=True, timeout=10)
+    assert result.returncode == 0, f"stdout={result.stdout!r} stderr={result.stderr!r}"
+    assert "OK" in result.stdout

tests/test_delete_printer_file_after_print.py

@@ -0,0 +1,157 @@
+"""Optional auto-delete of a printed file from the printer's own storage
+after a successful print (Settings -> Print -> "Delete file from printer
+after successful print").
+
+Only applies to files that are also backed by the bridge's own GCode store
+(otherwise the file would be gone with no copy left anywhere) and only on a
+clean "finished" state - not on stoped/canceled prints, and never when the
+setting is off (the default).
+"""
+import argparse
+import tempfile
+from unittest.mock import MagicMock
+
+from kobrax_moonraker_bridge import GCodeStore, KobraXBridge
+
+
+def _bridge(delete_after_print=1):
+    c = MagicMock()
+    c.callbacks = {}
+    c.connected = False
+    args = argparse.Namespace(
+        printer_ip="", mqtt_port=9883, username="", password="",
+        mode_id="20030", device_id="", host="127.0.0.1", port=7125,
+        data_dir=tempfile.mkdtemp(prefix="kxdelafterprint-"),
+        delete_printer_file_after_print=delete_after_print,
+    )
+    store = GCodeStore(args.data_dir)
+    b = KobraXBridge(c, args=args, store=store)
+    return b, c
+
+
+def _seed_file(bridge, filename="test.gcode"):
+    file_id = "abc123"
+    bridge._store.save_file(file_id, filename, b"; gcode content")
+    return file_id
+
+
+def _print_report(state, filename=None):
+    payload = {"state": state, "data": {}}
+    if filename is not None:
+        payload["data"]["filename"] = filename
+    return payload
+
+
+def test_finished_print_deletes_printer_file_when_enabled_and_in_store():
+    b, c = _bridge(delete_after_print=1)
+    _seed_file(b, "test.gcode")
+
+    b._on_print(_print_report("printing", "test.gcode"))
+    assert b._current_job_id
+    assert b._current_job_filename == "test.gcode"
+
+    b._on_print(_print_report("finished"))
+
+    delete_calls = [
+        call for call in c.publish.call_args_list
+        if call.args[:2] == ("file", "deleteBatch")
+    ]
+    assert len(delete_calls) == 1
+    payload = delete_calls[0].args[2]
+    assert payload == {"root": "local", "files": [{"path": "/", "filename": "test.gcode"}]}
+
+
+def test_finished_print_no_delete_when_setting_disabled():
+    b, c = _bridge(delete_after_print=0)
+    _seed_file(b, "test.gcode")
+
+    b._on_print(_print_report("printing", "test.gcode"))
+    b._on_print(_print_report("finished"))
+
+    delete_calls = [
+        call for call in c.publish.call_args_list
+        if call.args[:2] == ("file", "deleteBatch")
+    ]
+    assert delete_calls == []
+
+
+def test_finished_print_no_delete_when_file_not_in_bridge_store():
+    """Files started directly from the printer/Anycubic Slicer aren't in the
+    bridge's own GCode store - must never be deleted, since that would leave
+    no copy anywhere."""
+    b, c = _bridge(delete_after_print=1)
+    # No _seed_file() call - the file is not in the store.
+
+    b._on_print(_print_report("printing", "not_in_store.gcode"))
+    assert not b._current_job_id  # no store match -> no job tracked either
+
+    b._on_print(_print_report("finished"))
+
+    delete_calls = [
+        call for call in c.publish.call_args_list
+        if call.args[:2] == ("file", "deleteBatch")
+    ]
+    assert delete_calls == []
+
+
+def test_canceled_print_does_not_delete_file():
+    """Only a clean "finished" triggers the delete - a stopped/canceled
+    print keeps its file, since the user may want to retry it."""
+    b, c = _bridge(delete_after_print=1)
+    _seed_file(b, "test.gcode")
+
+    b._on_print(_print_report("printing", "test.gcode"))
+    b._on_print(_print_report("canceled"))
+
+    delete_calls = [
+        call for call in c.publish.call_args_list
+        if call.args[:2] == ("file", "deleteBatch")
+    ]
+    assert delete_calls == []
+    assert b._current_job_filename == ""
+
+
+def test_stoped_print_does_not_delete_file():
+    b, c = _bridge(delete_after_print=1)
+    _seed_file(b, "test.gcode")
+
+    b._on_print(_print_report("printing", "test.gcode"))
+    b._on_print(_print_report("stoped"))
+
+    delete_calls = [
+        call for call in c.publish.call_args_list
+        if call.args[:2] == ("file", "deleteBatch")
+    ]
+    assert delete_calls == []
+
+
+def test_current_job_filename_reset_after_finished():
+    """Regression guard: _current_job_filename must not leak into the next
+    print's finished-handling if that next print isn't itself tracked."""
+    b, c = _bridge(delete_after_print=1)
+    _seed_file(b, "test.gcode")
+
+    b._on_print(_print_report("printing", "test.gcode"))
+    b._on_print(_print_report("finished"))
+    assert b._current_job_filename == ""
+
+    # A second "finished" with no new job in between must not re-trigger a delete.
+    c.publish.reset_mock()
+    b._on_print(_print_report("finished"))
+    delete_calls = [
+        call for call in c.publish.call_args_list
+        if call.args[:2] == ("file", "deleteBatch")
+    ]
+    assert delete_calls == []
+
+
+def test_delete_publish_failure_does_not_raise():
+    """A broken MQTT send during the delete request must not propagate out
+    of _on_print() - it runs on the MQTT reader thread, and an unhandled
+    exception there would break processing of subsequent messages."""
+    b, c = _bridge(delete_after_print=1)
+    _seed_file(b, "test.gcode")
+    c.publish.side_effect = RuntimeError("send failed")
+
+    b._on_print(_print_report("printing", "test.gcode"))
+    b._on_print(_print_report("finished"))  # must not raise

tests/test_filament_profiles_per_printer.py

@@ -0,0 +1,67 @@
+"""Per-printer filament-profile isolation (config_loader).
+
+Regression test for the multi-printer bug (issue #74): the slot->profile mapping
+and ``visible_vendors`` lived in a single global ``[filament_profiles]`` section,
+so configuring one printer overwrote the other and after a restart both loaded
+the same map. Each printer now uses its own ``[filament_profiles_<id>]`` section,
+with a read-fallback to the legacy global section for backward compatibility.
+"""
+import sys
+import pathlib
+
+sys.path.insert(0, str(pathlib.Path(__file__).resolve().parent.parent))  # repo root
+import config_loader  # noqa: E402
+
+BASE_INI = (
+    "[printer_1]\nname = K1\n\n"
+    "[printer_2]\nname = K2\n\n"
+    "[filament_profiles]\n"
+    "visible_vendors = Anycubic, SUNLU\n"
+    "slot_0_vendor = Anycubic\nslot_0_name = Anycubic PLA+\nslot_0_id = GFPLA+\n"
+)
+
+
+def _use_ini(monkeypatch, tmp_path, text=BASE_INI):
+    path = tmp_path / "config.ini"
+    path.write_text(text, encoding="utf-8")
+    monkeypatch.setattr(config_loader, "_find_config_file", lambda: path)
+    return path
+
+
+def test_legacy_global_still_works(tmp_path, monkeypatch):
+    """No printer_id -> original global section (single-printer back-compat)."""
+    _use_ini(monkeypatch, tmp_path)
+    assert config_loader.list_filament_profiles()[0]["name"] == "Anycubic PLA+"
+    assert config_loader.list_visible_vendors() == ["Anycubic", "SUNLU"]
+
+
+def test_read_falls_back_to_global_until_first_save(tmp_path, monkeypatch):
+    """Before any per-printer save, both printers see the global mapping."""
+    _use_ini(monkeypatch, tmp_path)
+    assert config_loader.list_filament_profiles("1")[0]["name"] == "Anycubic PLA+"
+    assert config_loader.list_filament_profiles("2")[0]["name"] == "Anycubic PLA+"
+
+
+def test_saving_one_printer_does_not_touch_the_other(tmp_path, monkeypatch):
+    """Core regression: configuring printer 1 must not change printer 2."""
+    _use_ini(monkeypatch, tmp_path)
+    config_loader.save_filament_profiles(
+        {0: {"vendor": "KINGROON", "name": "KINGROON PLA Basic", "id": "Pc0b8a01"}}, "1")
+    assert config_loader.list_filament_profiles("1")[0]["name"] == "KINGROON PLA Basic"
+    assert config_loader.list_filament_profiles("2")[0]["name"] == "Anycubic PLA+"
+    # legacy global section preserved untouched
+    assert config_loader.list_filament_profiles()[0]["name"] == "Anycubic PLA+"
+
+
+def test_visible_vendors_isolated_per_printer(tmp_path, monkeypatch):
+    _use_ini(monkeypatch, tmp_path)
+    config_loader.save_visible_vendors(["KINGROON"], "1")
+    assert config_loader.list_visible_vendors("1") == ["KINGROON"]
+    assert config_loader.list_visible_vendors("2") == ["Anycubic", "SUNLU"]
+
+
+def test_save_visible_vendors_keeps_slot_fallback(tmp_path, monkeypatch):
+    """Creating a per-printer section only for vendors must not orphan slots."""
+    _use_ini(monkeypatch, tmp_path)
+    config_loader.save_visible_vendors(["KINGROON"], "1")
+    assert config_loader.list_filament_profiles("1")[0]["name"] == "Anycubic PLA+"

tests/test_metadata_and_print_state_reset.py

@@ -0,0 +1,151 @@
+"""server/files/metadata state-leak + terminal-state reset gaps (Issue #102).
+
+Reported by @fmontagna via moonraker-obico:
+1. Querying metadata for a file OTHER than the currently/last tracked job
+   leaked that job's live layer count / estimated time into the response,
+   because _build_file_metadata() read from self._state first and only fell
+   back to the file's own GCodeStore row when the state value was falsy.
+2. curr_layer/total_layers (and, for a successful "finished" print, every
+   other per-job field) were never reset at print end - they stayed at the
+   last job's values until the next print happened to overwrite them.
+3. The printer reports its own "progress" during pre-print phases
+   (preheating/auto_leveling/checking/...), which used to pass straight
+   through to display_status.progress/virtual_sdcard.progress and then jump
+   non-monotonically once real printing started and progress reset.
+"""
+import argparse
+import tempfile
+from unittest.mock import MagicMock
+
+from kobrax_moonraker_bridge import KobraXBridge
+
+
+def _bridge():
+    c = MagicMock(); c.callbacks = {}; c.connected = False
+    args = argparse.Namespace(
+        printer_ip="", mqtt_port=9883, username="", password="",
+        mode_id="20030", device_id="", host="127.0.0.1", port=7125,
+        data_dir=tempfile.mkdtemp(prefix="kxmeta-"),
+    )
+    return KobraXBridge(c, args=args)
+
+
+def _insert_store_row(b, filename, layer_count=None, est_time=None, size_bytes=0):
+    with b._store._lock:
+        b._store._conn.execute(
+            "INSERT OR REPLACE INTO gcode_files (id, filename, path, size_bytes, uploaded_at, layer_count, est_print_time_sec) "
+            "VALUES (?,?,?,?,?,?,?)",
+            (filename, filename, "/tmp/" + filename, size_bytes, "2026-01-01T00:00:00Z", layer_count, est_time),
+        )
+        b._store._conn.commit()
+
+
+# --- Fix 1: metadata state-leak -------------------------------------------
+
+def test_metadata_for_untracked_file_does_not_leak_running_job_state():
+    b = _bridge()
+    # A job is "running": live state has its own layer/time values.
+    b._state["filename"] = "running.gcode"
+    b._state["total_layers"] = 999
+    b._state["slicer_time"] = 12345
+    b._state["layer_height"] = 0.3
+
+    # Querying a DIFFERENT, unrelated file must use ITS OWN store row, not
+    # the running job's live state.
+    _insert_store_row(b, "other.gcode", layer_count=42, est_time=600, size_bytes=1000)
+    meta = b._build_file_metadata("other.gcode")
+    assert meta["layer_count"] == 42
+    assert meta["estimated_time"] == 600
+    assert meta["size"] == 1000
+
+
+def test_metadata_for_tracked_file_still_uses_live_state():
+    """The currently-tracked file's OWN metadata query should still prefer
+    live state (fresher than what was known at upload time)."""
+    b = _bridge()
+    b._state["filename"] = "running.gcode"
+    b._state["total_layers"] = 55
+    b._state["slicer_time"] = 999
+    _insert_store_row(b, "running.gcode", layer_count=1, est_time=1)
+    meta = b._build_file_metadata("running.gcode")
+    assert meta["layer_count"] == 55
+    assert meta["estimated_time"] == 999
+
+
+def test_metadata_for_nonexistent_file_falls_back_cleanly():
+    b = _bridge()
+    b._state["filename"] = "running.gcode"
+    b._state["total_layers"] = 999
+    meta = b._build_file_metadata("DOES_NOT_EXIST.gcode")
+    assert meta["layer_count"] is None
+    assert meta["size"] == 1  # documented fallback, unrelated to this fix
+
+
+# --- Fix 2: terminal-state reset -------------------------------------------
+
+def _print_payload(state, **extra):
+    """print/report envelope: `state` is top-level, everything else is under
+    `data` (see _on_print: kobra_state = payload.get("state", "")). """
+    d = {"filename": "job.gcode"}
+    d.update(extra)
+    return {"state": state, "data": d}
+
+
+def test_finished_resets_layer_fields_like_stoped_canceled():
+    b = _bridge()
+    b._state["curr_layer"] = 10
+    b._state["total_layers"] = 20
+    b._state["progress"] = 0.5
+    b._state["filename"] = "job.gcode"
+    b._on_print(_print_payload("finished"))
+    assert b._state["curr_layer"] == 0
+    assert b._state["total_layers"] == 0
+    assert b._state["progress"] == 0.0
+    assert b._state["filename"] == ""
+
+
+def test_canceled_resets_layer_fields():
+    b = _bridge()
+    b._state["curr_layer"] = 7
+    b._state["total_layers"] = 20
+    b._on_print(_print_payload("canceled"))
+    assert b._state["curr_layer"] == 0
+    assert b._state["total_layers"] == 0
+
+
+def test_on_info_resets_layer_fields_on_terminal_state():
+    b = _bridge()
+    b._state["curr_layer"] = 7
+    b._state["total_layers"] = 20
+    b._on_info({"data": {"project": {"state": "finished"}}})
+    assert b._state["curr_layer"] == 0
+    assert b._state["total_layers"] == 0
+
+
+# --- Fix 3: progress clamping during pre-print phases ----------------------
+
+def test_progress_not_updated_during_auto_leveling():
+    b = _bridge()
+    b._state["progress"] = 0.0
+    b._on_print(_print_payload("auto_leveling", progress=87))
+    assert b._state["progress"] == 0.0
+
+
+def test_progress_not_updated_during_preheating():
+    b = _bridge()
+    b._state["progress"] = 0.0
+    b._on_print(_print_payload("preheating", progress=42))
+    assert b._state["progress"] == 0.0
+
+
+def test_progress_updates_normally_once_printing():
+    b = _bridge()
+    b._on_print(_print_payload("printing", progress=33))
+    assert b._state["progress"] == 0.33
+
+
+def test_on_info_progress_clamped_during_checking():
+    b = _bridge()
+    b._state["progress"] = 0.0
+    b._on_info({"data": {"project": {"state": "checking", "progress": 55}}})
+    assert b._state["progress"] == 0.0

tests/test_mqtt_reconnect.py

@@ -0,0 +1,152 @@
+"""
+Tests für den MQTT-Reconnect-Mechanismus (Issue #105) — der Client hing nach
+einem Drucker-Reconnect fest, weil zwei unabhängige Fehlerpfade (der Reader-
+Thread-Keepalive und publish()'s eigener Reconnect-Trigger) unkoordiniert
+parallel liefen, UND weil der Poll-Loop einen None-Rückgabewert von publish()
+(statt einer Exception) nie als "Verbindung tot" erkannte.
+"""
+import threading
+import time
+
+import pytest
+
+from kobrax_client import KobraXClient
+
+
+def _client(**overrides):
+    kwargs = dict(
+        host="192.168.1.100", username="u", password="p",
+        mode_id="20030", device_id="abc123", port=9883,
+        client_id="test",
+    )
+    kwargs.update(overrides)
+    return KobraXClient(**kwargs)
+
+
+def test_is_connected_false_when_no_socket():
+    c = _client()
+    assert c.is_connected() is False
+
+
+def test_is_connected_true_when_socket_present():
+    c = _client()
+    c._sock = object()  # any truthy stand-in for a real socket
+    assert c.is_connected() is True
+
+
+def test_reconnect_concurrent_calls_only_run_do_connect_once():
+    """Two threads calling _reconnect() at the same time must not both run
+    _do_connect() - only one handshake should happen; the second caller waits
+    for the first instead of racing it (Issue #105)."""
+    c = _client()
+    c._running = True
+    do_connect_calls = []
+    call_lock = threading.Lock()
+    release_event = threading.Event()
+
+    def fake_do_connect():
+        with call_lock:
+            do_connect_calls.append(1)
+        # Simulate a slow handshake so the second _reconnect() call has time
+        # to observe the lock as already held.
+        release_event.wait(timeout=2.0)
+        c._sock = object()
+
+    c._do_connect = fake_do_connect
+
+    results = []
+
+    def run():
+        results.append(c._reconnect())
+
+    t1 = threading.Thread(target=run)
+    t2 = threading.Thread(target=run)
+    t1.start()
+    time.sleep(0.05)  # let t1 acquire the lock and enter _do_connect first
+    t2.start()
+    time.sleep(0.1)
+    release_event.set()  # let the in-flight handshake finish
+    t1.join(timeout=3)
+    t2.join(timeout=3)
+
+    assert len(do_connect_calls) == 1
+    assert results == [True, True]
+
+
+def test_reconnect_second_waiter_returns_after_first_completes():
+    c = _client()
+    c._running = True
+
+    def fake_do_connect():
+        time.sleep(0.1)
+        c._sock = object()
+
+    c._do_connect = fake_do_connect
+
+    t1 = threading.Thread(target=c._reconnect)
+    t1.start()
+    time.sleep(0.02)
+    # Second call while the first is still mid-handshake.
+    result = c._reconnect()
+    t1.join(timeout=3)
+
+    assert result is True
+    assert c._sock is not None
+
+
+def test_reconnect_non_blocking_returns_immediately_while_reconnect_in_progress():
+    """The poll-loop path (publish/publish_web) must NOT block while the reader
+    thread's persistent reconnect is running its multi-minute backoff loop -
+    it has to return so the poll loop can flip kobra_state to "offline".
+    A printer unplugged mid-connection otherwise left the dashboard stuck on
+    the last known state indefinitely (Issue #103 follow-up)."""
+    c = _client()
+    c._running = True
+    started = threading.Event()
+    release = threading.Event()
+
+    def slow_persistent_do_connect():
+        started.set()
+        # Simulate the printer still being gone: never succeeds until released.
+        release.wait(timeout=5.0)
+        raise OSError("still unreachable")
+
+    c._do_connect = slow_persistent_do_connect
+
+    # First reconnect (reader-thread style): persistent, holds the lock, stuck
+    # in backoff.
+    t1 = threading.Thread(target=lambda: c._reconnect(persist=True), daemon=True)
+    t1.start()
+    assert started.wait(timeout=2.0)
+
+    # Poll-loop style call must return basically instantly, not block on t1.
+    t0 = time.time()
+    result = c._reconnect(wait_if_in_progress=False, persist=False)
+    elapsed = time.time() - t0
+
+    assert elapsed < 0.5, f"non-blocking reconnect blocked for {elapsed:.2f}s"
+    assert result is False  # socket is down while the other reconnect churns
+
+    release.set()  # let the daemon thread unwind
+
+
+def test_reconnect_one_shot_does_not_loop_on_failure():
+    """persist=False must attempt the handshake at most once and return,
+    instead of entering the backoff loop (which would block the caller)."""
+    c = _client()
+    c._running = True
+    attempts = []
+
+    def failing_do_connect():
+        attempts.append(1)
+        raise OSError("unreachable")
+
+    c._do_connect = failing_do_connect
+
+    t0 = time.time()
+    result = c._reconnect(persist=False)
+    elapsed = time.time() - t0
+
+    assert result is False
+    assert len(attempts) == 1  # exactly one attempt, no backoff retries
+    assert elapsed < 0.5

tests/test_multi_ace_slots.py

@@ -0,0 +1,117 @@
+"""Multi-ACE aggregation in ace_direct mode (Issue #95, Kobra S1).
+
+A Kobra S1 with two daisy-chained ACE Pro units reports
+multi_color_box = [{id:0, slots:[4]}, {id:1, slots:[4]}] with NO toolhead
+entry (id:-1). The old ace_direct branch kept only ace_boxes[0], silently
+dropping the second unit — the dashboard and the OrcaSlicer sync only ever
+saw 4 of the 8 slots. Payloads below are trimmed from the real log attached
+to the issue.
+"""
+from kobrax_moonraker_bridge import KobraXBridge
+
+
+def _slot(index, type_="PLA", color=(1, 2, 3), status=5):
+    return {
+        "index": index, "sku": "", "type": type_, "color": list(color),
+        "edit_status": 0, "status": status,
+        "color_group": [list(color) + [255]], "icon_type": 0,
+        "consumables_percent": 50,
+    }
+
+
+def _ace_box(box_id, loaded_slot=-1, n_slots=4):
+    return {
+        "id": box_id, "status": 1, "model_id": 0, "auto_feed": 1,
+        "loaded_slot": loaded_slot,
+        "feed_status": {"code": 200, "type": -1, "current_status": -1, "slot_index": -1},
+        "temp": 30, "humidity": 0,
+        "drying_status": {"status": 0, "target_temp": 0, "duration": 0, "remain_time": 0},
+        "slots": [_slot(i) for i in range(n_slots)],
+    }
+
+
+def _toolhead_box(n_slots=4):
+    box = _ace_box(-1, n_slots=n_slots)
+    return box
+
+
+# ── mode detection ───────────────────────────────────────────────────────────
+
+def test_two_ace_units_no_toolhead_is_ace_direct():
+    boxes = [_ace_box(0), _ace_box(1)]
+    assert KobraXBridge._detect_filament_mode(boxes) == "ace_direct"
+
+
+# ── ace_direct aggregation ───────────────────────────────────────────────────
+
+def test_single_ace_unit_yields_4_slots():
+    """Kobra X regression: one unit, global indices 0-3 exactly as before."""
+    slots, loaded = KobraXBridge._aggregate_slots([_ace_box(0)], "ace_direct")
+    assert len(slots) == 4
+    assert [s["global_index"] for s in slots] == [0, 1, 2, 3]
+    assert all(s["box_id"] == 0 for s in slots)
+    assert loaded == -1
+
+
+def test_two_ace_units_yield_8_slots():
+    """Issue #95: the second unit's slots must appear as global 4-7."""
+    slots, loaded = KobraXBridge._aggregate_slots([_ace_box(0), _ace_box(1)], "ace_direct")
+    assert len(slots) == 8
+    assert [s["global_index"] for s in slots] == [0, 1, 2, 3, 4, 5, 6, 7]
+    assert [s["box_id"] for s in slots] == [0, 0, 0, 0, 1, 1, 1, 1]
+
+
+def test_two_ace_units_report_order_does_not_matter():
+    """Boxes sorted by id — global numbering stays stable if the firmware
+    reports unit 1 before unit 0."""
+    slots, _ = KobraXBridge._aggregate_slots([_ace_box(1), _ace_box(0)], "ace_direct")
+    assert [s["global_index"] for s in slots] == [0, 1, 2, 3, 4, 5, 6, 7]
+    assert [s["box_id"] for s in slots] == [0, 0, 0, 0, 1, 1, 1, 1]
+
+
+def test_loaded_slot_on_second_unit_maps_to_global():
+    slots, loaded = KobraXBridge._aggregate_slots(
+        [_ace_box(0), _ace_box(1, loaded_slot=2)], "ace_direct")
+    assert loaded == 6  # 1*4 + 2
+
+
+def test_loaded_slot_on_first_unit_unchanged():
+    slots, loaded = KobraXBridge._aggregate_slots(
+        [_ace_box(0, loaded_slot=3), _ace_box(1)], "ace_direct")
+    assert loaded == 3
+
+
+# ── ace_hub regression (unchanged behavior) ──────────────────────────────────
+
+def test_ace_hub_numbering_unchanged():
+    boxes = [_toolhead_box(), _ace_box(0), _ace_box(1)]
+    assert KobraXBridge._detect_filament_mode(boxes) == "ace_hub"
+    slots, _ = KobraXBridge._aggregate_slots(boxes, "ace_hub")
+    # 3 toolhead + 4 + 4 ACE
+    assert len(slots) == 11
+    assert [s["global_index"] for s in slots] == [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
+    assert [s["box_id"] for s in slots][:3] == [-1, -1, -1]
+
+
+# ── _box_local_to_global / _global_to_box_slot round-trip ────────────────────
+
+def _bridge_with_mode(mode, slots):
+    b = object.__new__(KobraXBridge)
+    b._filament_mode = mode
+    b._ams_slots = slots
+    return b
+
+
+def test_box_local_to_global_ace_direct_second_unit():
+    b = _bridge_with_mode("ace_direct", [])
+    assert b._box_local_to_global(0, 2, []) == 2
+    assert b._box_local_to_global(1, 2, []) == 6
+
+
+def test_global_to_box_slot_round_trip_two_units():
+    slots, _ = KobraXBridge._aggregate_slots([_ace_box(0), _ace_box(1)], "ace_direct")
+    b = _bridge_with_mode("ace_direct", slots)
+    for g in range(8):
+        box_id, local = b._global_to_box_slot(g)
+        assert (box_id, local) == (g // 4, g % 4)
+        assert b._box_local_to_global(box_id, local, []) == g

tests/test_multicolor_box_failed_state.py

@@ -0,0 +1,81 @@
+"""AttributeError crash on multiColorBox/report failure (Issue #100).
+
+Real KX2-Pro bug: manually assigning a filament profile to an ACE slot
+(custom-RFID / third-party filament) gets rejected by the printer. Instead of
+echoing the normal success shape, the printer replies with `state: "failed"`
+and `data` as a 2-element LIST (`["multi_color_box", [...]]`) instead of the
+usual dict (`{"multi_color_box": [...]}`). `_on_multicolor_box` called
+`data.get(...)` unconditionally, crashing with
+`AttributeError: 'list' object has no attribute 'get'` and silently dropping
+the report (including the slot-state update it would otherwise have done).
+"""
+import argparse
+import tempfile
+from unittest.mock import MagicMock
+
+from kobrax_moonraker_bridge import KobraXBridge
+
+# Exact failure payload from the Issue #100 log.
+FAILED_PAYLOAD = {
+    "state": "failed",
+    "data": ["multi_color_box", [{"filaments": {"id": 2}, "id": 0}]],
+}
+
+SUCCESS_PAYLOAD = {
+    "state": "success",
+    "data": {
+        "head_tools_model": 1,
+        "multi_color_box": [
+            {"id": -1, "slots": []},
+            {
+                "id": 0,
+                "slots": [
+                    {"index": 0, "type": "PLA", "color": [0, 156, 189], "status": 5},
+                ],
+            },
+        ],
+    },
+}
+
+
+def _bridge():
+    c = MagicMock(); c.callbacks = {}; c.connected = False
+    args = argparse.Namespace(
+        printer_ip="", mqtt_port=9883, username="", password="",
+        mode_id="20030", device_id="", host="127.0.0.1", port=7125,
+        data_dir=tempfile.mkdtemp(prefix="kxmcb-"),
+    )
+    return KobraXBridge(c, args=args)
+
+
+def test_failed_state_does_not_crash():
+    b = _bridge()
+    b._on_multicolor_box(FAILED_PAYLOAD)  # must not raise
+    assert b._state["last_ams_set_error"] is True
+
+
+def test_success_after_failure_clears_error_flag():
+    b = _bridge()
+    b._on_multicolor_box(FAILED_PAYLOAD)
+    assert b._state["last_ams_set_error"] is True
+    b._on_multicolor_box(SUCCESS_PAYLOAD)
+    assert b._state["last_ams_set_error"] is False
+
+
+def test_non_dict_data_without_failed_state_does_not_crash():
+    """Defensive guard: any future non-dict `data` shape must not crash,
+    even if the printer doesn't set state="failed" for it."""
+    b = _bridge()
+    b._on_multicolor_box({"state": "success", "data": ["multi_color_box", []]})
+
+
+def test_failed_report_is_logged_with_the_triggering_request(caplog):
+    """The failure payload alone carries no slot/type/color info - the log
+    must correlate it with the setInfo request that triggered it, otherwise
+    the failure reason can't be diagnosed from bridge logs alone."""
+    import logging
+    b = _bridge()
+    b._last_ams_set_request = {"global": 6, "box": 0, "local_slot": 3, "type": "PLA", "color": [33, 39, 33]}
+    with caplog.at_level(logging.WARNING):
+        b._on_multicolor_box(FAILED_PAYLOAD)
+    assert any("global" in r.message and "6" in r.message for r in caplog.records)

tests/test_orca_filaments_parser.py

@@ -0,0 +1,182 @@
+"""orca_filaments.py parser robustness (code review finding).
+
+No dedicated test file existed for parse_profile()/parse_profile_bytes()/
+clean_name() before this - existing tests only used pre-parsed profile dicts
+as fixtures, never exercised the actual parsing logic.
+"""
+import json
+import logging
+
+from orca_filaments import clean_name, first_str, parse_profile, parse_profile_bytes
+
+
+def test_clean_name_strips_base_suffix():
+    assert clean_name("PolyTerra PLA @base") == "PolyTerra PLA"
+
+
+def test_clean_name_strips_printer_and_nozzle_suffix():
+    assert clean_name("Anycubic PLA @Anycubic Kobra X 0.4 nozzle") == "Anycubic PLA"
+
+
+def test_clean_name_strips_bare_nozzle_suffix():
+    assert clean_name("Anker Generic PLA 0.4 nozzle") == "Anker Generic PLA"
+
+
+def test_clean_name_returns_raw_when_stripping_leaves_nothing():
+    """An all-suffix name has nothing left after stripping - falls back to
+    the original raw string rather than returning an empty string."""
+    assert clean_name("@base") == "@base"
+
+
+def test_first_str_unwraps_single_element_list():
+    assert first_str(["PLA"]) == "PLA"
+
+
+def test_first_str_passes_through_plain_string():
+    assert first_str("PLA") == "PLA"
+
+
+def test_first_str_returns_default_for_empty_list():
+    assert first_str([], "fallback") == "fallback"
+
+
+def test_first_str_returns_default_for_other_types():
+    assert first_str(42, "fallback") == "fallback"
+    assert first_str(None, "fallback") == "fallback"
+
+
+def test_parse_profile_rejects_non_dict():
+    assert parse_profile([1, 2, 3]) is None
+    assert parse_profile("not a dict") is None
+    assert parse_profile(None) is None
+
+
+def test_parse_profile_rejects_stub_without_id_or_parent():
+    data = {"type": "filament"}  # no inherits, no filament_id
+    assert parse_profile(data) is None
+
+
+def test_parse_profile_rejects_instantiation_false():
+    data = {"type": "filament", "filament_id": "GFL01", "instantiation": "false"}
+    assert parse_profile(data) is None
+
+
+def test_parse_profile_minimal_valid_profile():
+    data = {
+        "type": "filament",
+        "filament_id": "GFL01",
+        "name": "Generic PLA",
+        "filament_vendor": ["Generic"],
+        "filament_type": ["PLA"],
+        "default_filament_colour": ["#FFFFFF"],
+    }
+    result = parse_profile(data)
+    assert result == {
+        "id": "GFL01",
+        "name": "Generic PLA",
+        "vendor": "Generic",
+        "type": "PLA",
+        "color": "#FFFFFF",
+    }
+
+
+def test_parse_profile_name_as_list_does_not_crash():
+    """Regression guard: `name` wasn't previously routed through first_str()
+    like the other fields are, unlike filament_vendor/filament_type/
+    default_filament_colour just below it - a list value here used to raise
+    TypeError inside clean_name()'s re.sub()."""
+    data = {
+        "type": "filament",
+        "filament_id": "GFL02",
+        "name": ["Geeetech PLA Basic"],
+        "filament_vendor": ["Geeetech"],
+        "filament_type": ["PLA"],
+    }
+    result = parse_profile(data)
+    assert result is not None
+    assert result["name"] == "Geeetech PLA Basic"
+
+
+def test_parse_profile_missing_name_falls_back_to_filament_id():
+    data = {"type": "filament", "filament_id": "GFL03", "filament_vendor": ["Generic"]}
+    result = parse_profile(data)
+    assert result["name"] == "GFL03"
+
+
+def test_parse_profile_missing_optional_fields_default_to_empty_string():
+    data = {"type": "filament", "filament_id": "GFL04", "name": "Mystery Filament"}
+    result = parse_profile(data)
+    assert result["type"] == ""
+    assert result["color"] == ""
+    assert result["vendor"] == "Generic"  # no path_vendor given either
+
+
+def test_parse_profile_inherits_via_by_name():
+    parent = {"type": "filament", "filament_id": "GFL05", "filament_vendor": ["Geeetech"], "filament_type": ["PLA"]}
+    child = {"type": "filament", "inherits": "Geeetech PLA @base", "name": "Geeetech PLA Basic"}
+    by_name = {"Geeetech PLA @base": [parent]}
+    result = parse_profile(child, by_name=by_name)
+    assert result is not None
+    assert result["id"] == "GFL05"
+    assert result["vendor"] == "Geeetech"
+    assert result["type"] == "PLA"
+
+
+def test_parse_profile_inherits_via_system_index():
+    system_index = [{
+        "id": "GFL06", "name": "Geeetech PLA", "vendor": "Geeetech", "type": "PLA", "color": "",
+    }]
+    user_profile = {"type": "filament", "inherits": "Geeetech PLA @base", "name": "My Geeetech Override"}
+    result = parse_profile(user_profile, system_index=system_index)
+    assert result is not None
+    assert result["id"] == "GFL06"
+    assert result["vendor"] == "Geeetech"
+
+
+def test_parse_profile_inherits_cycle_does_not_infinite_loop():
+    """A inherits B, B inherits A - _resolve()'s hard depth=5 bound must
+    terminate this rather than recursing forever."""
+    a = {"type": "filament", "inherits": "B"}
+    b = {"type": "filament", "inherits": "A"}
+    by_name = {"A": [a], "B": [b]}
+    # Neither profile has a filament_id anywhere in the cycle - must return
+    # None (not hang, not crash) after exhausting the depth limit.
+    result = parse_profile(a, by_name=by_name)
+    assert result is None
+
+
+def test_parse_profile_duplicate_system_names_logs_and_uses_last(caplog):
+    """clean_name() deliberately collapses variant-suffixed names onto the
+    same cleaned name - sys_by_name's last-write-wins overwrite on collision
+    is expected, but must now be observable via a debug log instead of
+    silent."""
+    system_index = [
+        {"id": "GFL07", "name": "PolyTerra PLA", "vendor": "Polymaker", "type": "PLA", "color": ""},
+        {"id": "GFL08", "name": "PolyTerra PLA", "vendor": "Polymaker", "type": "PLA", "color": ""},
+    ]
+    user_profile = {"type": "filament", "inherits": "PolyTerra PLA @base", "name": "Override"}
+    with caplog.at_level(logging.DEBUG, logger="kobrax.filaments"):
+        result = parse_profile(user_profile, system_index=system_index)
+    assert result is not None
+    assert result["id"] == "GFL08"  # last one wins, as before
+    assert any("duplicate system profile name" in r.message for r in caplog.records)
+
+
+def test_parse_profile_bytes_valid_json():
+    blob = json.dumps({
+        "type": "filament", "filament_id": "GFL09", "name": "Test PLA",
+        "filament_vendor": ["Test"], "filament_type": ["PLA"],
+    }).encode("utf-8")
+    result = parse_profile_bytes(blob)
+    assert result is not None
+    assert result["id"] == "GFL09"
+
+
+def test_parse_profile_bytes_malformed_json_returns_none():
+    assert parse_profile_bytes(b"{not valid json") is None
+
+
+def test_parse_profile_bytes_non_dict_json_returns_none():
+    assert parse_profile_bytes(b"[1, 2, 3]") is None
+    assert parse_profile_bytes(b'"just a string"') is None
+    assert parse_profile_bytes(b"42") is None

tests/test_poll_loop_reconnect.py

@@ -0,0 +1,96 @@
+"""
+Tests für _poll_loop's Umgang mit einer toten MQTT-Session (Issue #105).
+publish()/query_info() swallow send failures internally and return None
+instead of raising - the poll loop must treat that (combined with
+is_connected() == False) as "connection lost" and switch to the offline
+branch, instead of silently retrying forever every poll_interval.
+"""
+import argparse
+import tempfile
+import threading
+import time
+from unittest.mock import MagicMock
+
+import pytest
+
+from kobrax_moonraker_bridge import KobraXBridge
+
+
+def _bridge():
+    c = MagicMock()
+    c.callbacks = {}
+    c.connected = False
+    args = argparse.Namespace(
+        printer_ip="192.168.1.100", mqtt_port=9883, username="", password="",
+        mode_id="20030", device_id="", host="127.0.0.1", port=7125,
+        data_dir=tempfile.mkdtemp(prefix="kxpoll-"), poll_interval=0.05,
+    )
+    return KobraXBridge(c, args=args)
+
+
+def test_poll_loop_switches_to_offline_when_query_returns_none_and_disconnected():
+    b = _bridge()
+    b._state["print_state"] = "standby"
+    b._state["kobra_state"] = "free"
+    b.client.query_info.return_value = None
+    b.client.is_connected.return_value = False
+    b._printer_reachable = MagicMock(return_value=True)  # TCP still fine
+
+    stop_event = threading.Event()
+    t = threading.Thread(target=b._poll_loop, args=(stop_event,), daemon=True)
+    t.start()
+    time.sleep(0.2)
+    stop_event.set()
+    t.join(timeout=2)
+
+    assert b._state["kobra_state"] == "offline"
+    b.client.disconnect.assert_called()
+
+
+def test_poll_loop_stays_online_when_query_returns_none_but_still_connected():
+    """A single missed poll tick (info momentarily falsy) must not flip the
+    bridge offline if the MQTT session itself is still alive."""
+    b = _bridge()
+    b._state["print_state"] = "standby"
+    b._state["kobra_state"] = "free"
+    b.client.query_info.return_value = None
+    b.client.is_connected.return_value = True  # session still up
+    b.client.query_multicolor_box.return_value = None
+    b._printer_reachable = MagicMock(return_value=True)
+
+    stop_event = threading.Event()
+    t = threading.Thread(target=b._poll_loop, args=(stop_event,), daemon=True)
+    t.start()
+    time.sleep(0.2)
+    stop_event.set()
+    t.join(timeout=2)
+
+    assert b._state["kobra_state"] != "offline"
+
+
+def test_poll_loop_recovers_via_offline_branch_once_reachable_again():
+    """Once flipped offline, the existing offline branch should re-connect
+    as soon as the printer becomes reachable again (pre-existing behavior,
+    unaffected by this fix)."""
+    b = _bridge()
+    b._state["print_state"] = "standby"
+    b._state["kobra_state"] = "free"
+    b.client.query_info.return_value = None
+    b.client.is_connected.return_value = False
+    b._printer_reachable = MagicMock(return_value=True)
+
+    stop_event = threading.Event()
+    t = threading.Thread(target=b._poll_loop, args=(stop_event,), daemon=True)
+    t.start()
+    time.sleep(0.15)  # let it flip offline
+    assert b._state["kobra_state"] == "offline"
+
+    # Printer "comes back": client.connect() succeeds, subsequent query_info
+    # starts returning real data again.
+    b.client.connect.side_effect = None
+    b.client.query_info.return_value = {"data": {"state": "free"}}
+    time.sleep(0.2)
+    stop_event.set()
+    t.join(timeout=2)
+
+    b.client.connect.assert_called()

tests/test_printer_files_endpoint.py

@@ -0,0 +1,233 @@
+"""
+Tests für /kx/printer-files (list) und /kx/printer-files/delete —
+der zweite Browser-Tab, der Dateien auf dem Drucker selbst zeigt
+(via MQTT file/listLocal + file/deleteBatch, live gegen den echten
+Kobra X verifiziert, siehe Memory reference_mqtt_listlocal.md).
+
+Important: publish()'s own return value for these actions is just a
+generic immediate ACK skeleton (code=0, empty fields) - the real answer
+arrives asynchronously via the file/report callback (_on_file), same as
+the existing fileDetails fire-and-forget pattern. So publish() itself
+returns None/skeleton here, and the "real" response is delivered by
+firing bridge._on_file(...) from a background thread, simulating what
+the MQTT reader thread would do when the printer's file/report arrives.
+"""
+import threading
+import time
+
+import pytest
+
+
+LISTLOCAL_SUCCESS = {
+    "action": "listLocal",
+    "code": 200,
+    "state": "success",
+    "data": {
+        "list_mode": 0,
+        "records": [
+            {"filename": "a.gcode", "is_dir": False, "size": 100, "timestamp": 1700000000000},
+            {"filename": "subdir", "is_dir": True, "size": 0, "timestamp": 1700000001000},
+            {"filename": "b.gcode", "is_dir": False, "size": 200, "timestamp": 1700000002000},
+        ],
+    },
+}
+
+LISTLOCAL_FAILED = {
+    "action": "listLocal",
+    "code": 10112,
+    "state": "failed",
+    "data": None,
+}
+
+DELETEBATCH_SUCCESS = {
+    "action": "deleteBatch",
+    "code": 200,
+    "state": "success",
+    "data": None,
+    "msg": "done",
+}
+
+DELETEBATCH_FAILED = {
+    "action": "deleteBatch",
+    "code": 10112,
+    "state": "failed",
+    "data": None,
+}
+
+FILEDETAILS_SUCCESS = {
+    "action": "fileDetails",
+    "code": 200,
+    "state": "done",
+    "data": {
+        "file_details": {
+            "thumbnail": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB",
+            "png_image": "",
+            "svg_image": "",
+            "objects_skip_parts": [],
+        },
+        "filename": "a.gcode",
+        "root": "local",
+    },
+}
+
+FILEDETAILS_NO_THUMBNAIL = {
+    "action": "fileDetails",
+    "code": 200,
+    "state": "done",
+    "data": {
+        "file_details": {"thumbnail": "", "png_image": "", "svg_image": "", "objects_skip_parts": []},
+        "filename": "a.gcode",
+        "root": "local",
+    },
+}
+
+FILEDETAILS_FAILED = {
+    "action": "fileDetails",
+    "code": 10112,
+    "state": "failed",
+    "data": None,
+}
+
+
+def _deliver_async(bridge, payload, delay=0.05):
+    """Simulates the MQTT reader thread delivering a file/report a moment
+    after the fire-and-forget publish() call returns."""
+    def _fire():
+        time.sleep(delay)
+        bridge._on_file(payload)
+    threading.Thread(target=_fire, daemon=True).start()
+
+
+@pytest.mark.asyncio
+async def test_printer_files_lists_files_and_excludes_dirs(client):
+    c, bridge = client
+    bridge.client.publish.side_effect = lambda *a, **kw: (_deliver_async(bridge, LISTLOCAL_SUCCESS), None)[1]
+    resp = await c.get("/kx/printer-files")
+    assert resp.status == 200
+    data = await resp.json()
+    filenames = [f["filename"] for f in data["result"]]
+    assert filenames == ["a.gcode", "b.gcode"]  # "subdir" (is_dir=True) excluded
+
+
+@pytest.mark.asyncio
+async def test_printer_files_uses_correct_mqtt_payload(client):
+    c, bridge = client
+    bridge.client.publish.side_effect = lambda *a, **kw: (_deliver_async(bridge, LISTLOCAL_SUCCESS), None)[1]
+    await c.get("/kx/printer-files")
+    args, kwargs = bridge.client.publish.call_args
+    assert args[0] == "file"
+    assert args[1] == "listLocal"
+    assert args[2] == {"page_num": 1, "page_size": 200, "path": "/"}
+
+
+@pytest.mark.asyncio
+async def test_printer_files_returns_502_on_printer_failure(client):
+    c, bridge = client
+    bridge.client.publish.side_effect = lambda *a, **kw: (_deliver_async(bridge, LISTLOCAL_FAILED), None)[1]
+    resp = await c.get("/kx/printer-files")
+    assert resp.status == 502
+
+
+@pytest.mark.asyncio
+async def test_printer_files_returns_502_on_timeout(client):
+    c, bridge = client
+    bridge.client.publish.return_value = None  # no file/report ever arrives
+    resp = await c.get("/kx/printer-files")
+    assert resp.status == 502
+
+
+@pytest.mark.asyncio
+async def test_printer_file_delete_success(client):
+    c, bridge = client
+    bridge.client.publish.side_effect = lambda *a, **kw: (_deliver_async(bridge, DELETEBATCH_SUCCESS), None)[1]
+    resp = await c.post("/kx/printer-files/delete", json={"filenames": ["a.gcode"]})
+    assert resp.status == 200
+    data = await resp.json()
+    assert data["result"] == "ok"
+
+
+@pytest.mark.asyncio
+async def test_printer_file_delete_uses_correct_mqtt_payload(client):
+    c, bridge = client
+    bridge.client.publish.side_effect = lambda *a, **kw: (_deliver_async(bridge, DELETEBATCH_SUCCESS), None)[1]
+    await c.post("/kx/printer-files/delete", json={"filenames": ["a.gcode", "b.gcode"]})
+    args, kwargs = bridge.client.publish.call_args
+    assert args[0] == "file"
+    assert args[1] == "deleteBatch"
+    assert args[2] == {
+        "root": "local",
+        "files": [
+            {"path": "/", "filename": "a.gcode"},
+            {"path": "/", "filename": "b.gcode"},
+        ],
+    }
+
+
+@pytest.mark.asyncio
+async def test_printer_file_delete_empty_filenames_returns_400(client):
+    c, _ = client
+    resp = await c.post("/kx/printer-files/delete", json={"filenames": []})
+    assert resp.status == 400
+
+
+@pytest.mark.asyncio
+async def test_printer_file_delete_returns_502_on_printer_rejection(client):
+    c, bridge = client
+    bridge.client.publish.side_effect = lambda *a, **kw: (_deliver_async(bridge, DELETEBATCH_FAILED), None)[1]
+    resp = await c.post("/kx/printer-files/delete", json={"filenames": ["a.gcode"]})
+    assert resp.status == 502
+
+
+@pytest.mark.asyncio
+async def test_printer_file_thumbnail_success(client):
+    c, bridge = client
+    bridge.client.publish.side_effect = lambda *a, **kw: (_deliver_async(bridge, FILEDETAILS_SUCCESS), None)[1]
+    resp = await c.get("/kx/printer-files/a.gcode/thumbnail")
+    assert resp.status == 200
+    data = await resp.json()
+    assert data["result"]["thumbnail"] == "iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB"
+
+
+@pytest.mark.asyncio
+async def test_printer_file_thumbnail_uses_correct_mqtt_payload(client):
+    c, bridge = client
+    bridge.client.publish.side_effect = lambda *a, **kw: (_deliver_async(bridge, FILEDETAILS_SUCCESS), None)[1]
+    await c.get("/kx/printer-files/a.gcode/thumbnail")
+    args, kwargs = bridge.client.publish.call_args
+    assert args[0] == "file"
+    assert args[1] == "fileDetails"
+    assert args[2] == {"root": "local", "filename": "a.gcode"}
+
+
+@pytest.mark.asyncio
+async def test_printer_file_thumbnail_empty_when_no_thumbnail_embedded(client):
+    c, bridge = client
+    bridge.client.publish.side_effect = lambda *a, **kw: (_deliver_async(bridge, FILEDETAILS_NO_THUMBNAIL), None)[1]
+    resp = await c.get("/kx/printer-files/a.gcode/thumbnail")
+    assert resp.status == 200
+    data = await resp.json()
+    assert data["result"]["thumbnail"] == ""
+
+
+@pytest.mark.asyncio
+async def test_printer_file_thumbnail_returns_502_on_printer_failure(client):
+    c, bridge = client
+    bridge.client.publish.side_effect = lambda *a, **kw: (_deliver_async(bridge, FILEDETAILS_FAILED), None)[1]
+    resp = await c.get("/kx/printer-files/a.gcode/thumbnail")
+    assert resp.status == 502
+
+
+@pytest.mark.asyncio
+async def test_printer_file_thumbnail_is_cached_after_first_fetch(client):
+    """Second request for the same filename must not call publish() again."""
+    c, bridge = client
+    bridge.client.publish.side_effect = lambda *a, **kw: (_deliver_async(bridge, FILEDETAILS_SUCCESS), None)[1]
+    resp1 = await c.get("/kx/printer-files/a.gcode/thumbnail")
+    assert resp1.status == 200
+    call_count_after_first = bridge.client.publish.call_count
+
+    resp2 = await c.get("/kx/printer-files/a.gcode/thumbnail")
+    assert resp2.status == 200
+    data2 = await resp2.json()
+    assert data2["result"]["thumbnail"] == "iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB"
+    assert bridge.client.publish.call_count == call_count_after_first  # no new MQTT call

tests/test_printer_power.py

@@ -0,0 +1,175 @@
+"""External smart-plug power control (Issue #103).
+
+The printer itself has no MQTT command to power off or enter standby - only
+heaters/motors/etc. can be controlled remotely. For users running the
+printer through a Tasmota-style smart plug, the bridge exposes plain
+HTTP GET on/off/status URLs (configured per printer) as its own dashboard
+button, instead of routing through Moonraker's device_power API.
+"""
+import argparse
+import tempfile
+from unittest.mock import AsyncMock, MagicMock, patch
+
+import pytest
+import pytest_asyncio
+from aiohttp.test_utils import TestClient, TestServer
+
+from kobrax_moonraker_bridge import KobraXBridge, build_app
+
+
+def _make_bridge(pid="1", **arg_overrides):
+    c = MagicMock()
+    c.callbacks = {}
+    c.connected = False
+    args = argparse.Namespace(
+        printer_ip="192.168.1.50", mqtt_port=9883, username="", password="",
+        mode_id="20030", device_id="", host="127.0.0.1", port=7125,
+        data_dir=tempfile.mkdtemp(prefix="kxpower-"),
+        power_on_url="", power_off_url="", power_status_url="",
+    )
+    for k, v in arg_overrides.items():
+        setattr(args, k, v)
+    all_bridges = {}
+    bridge = KobraXBridge(c, args=args, printer_id=pid, all_bridges=all_bridges)
+    all_bridges[pid] = bridge
+    return bridge
+
+
+@pytest_asyncio.fixture
+async def power_client():
+    bridge = _make_bridge(
+        power_on_url="http://192.168.1.99/cm?cmnd=Power%20on",
+        power_off_url="http://192.168.1.99/cm?cmnd=Power%20off",
+        power_status_url="http://192.168.1.99/cm?cmnd=Power",
+    )
+    app = build_app(bridge)
+    async with TestClient(TestServer(app)) as c:
+        yield c, bridge
+
+
+def _fake_get_response(status=200, text=""):
+    resp = MagicMock()
+    resp.status = status
+    resp.text = AsyncMock(return_value=text)
+    ctx = MagicMock()
+    ctx.__aenter__ = AsyncMock(return_value=resp)
+    ctx.__aexit__ = AsyncMock(return_value=False)
+    return ctx
+
+
+@pytest.mark.asyncio
+async def test_printers_list_reports_has_power_control(power_client):
+    c, bridge = power_client
+    resp = await c.get("/kx/printers")
+    data = await resp.json()
+    assert data["result"][0]["has_power_control"] is True
+
+
+@pytest.mark.asyncio
+async def test_printers_list_no_power_control_when_unconfigured():
+    bridge = _make_bridge()
+    app = build_app(bridge)
+    async with TestClient(TestServer(app)) as c:
+        resp = await c.get("/kx/printers")
+        data = await resp.json()
+        assert data["result"][0]["has_power_control"] is False
+
+
+@pytest.mark.asyncio
+async def test_power_on_hits_configured_url(power_client):
+    c, bridge = power_client
+    with patch("aiohttp.ClientSession.get", return_value=_fake_get_response(200)) as mock_get:
+        resp = await c.post("/kx/printers/1/power", json={"action": "on"})
+        data = await resp.json()
+    assert resp.status == 200
+    assert data["result"] == "ok"
+    mock_get.assert_called_once()
+    assert mock_get.call_args[0][0] == "http://192.168.1.99/cm?cmnd=Power%20on"
+
+
+@pytest.mark.asyncio
+async def test_power_off_hits_configured_url(power_client):
+    c, bridge = power_client
+    with patch("aiohttp.ClientSession.get", return_value=_fake_get_response(200)) as mock_get:
+        resp = await c.post("/kx/printers/1/power", json={"action": "off"})
+        data = await resp.json()
+    assert resp.status == 200
+    assert data["result"] == "ok"
+    assert mock_get.call_args[0][0] == "http://192.168.1.99/cm?cmnd=Power%20off"
+
+
+@pytest.mark.asyncio
+async def test_power_invalid_action_rejected(power_client):
+    c, bridge = power_client
+    resp = await c.post("/kx/printers/1/power", json={"action": "toggle"})
+    assert resp.status == 400
+
+
+@pytest.mark.asyncio
+async def test_power_unknown_printer_id_404(power_client):
+    c, bridge = power_client
+    resp = await c.post("/kx/printers/99/power", json={"action": "on"})
+    assert resp.status == 404
+
+
+@pytest.mark.asyncio
+async def test_power_missing_url_configured_error():
+    bridge = _make_bridge()  # no power_on_url set
+    app = build_app(bridge)
+    async with TestClient(TestServer(app)) as c:
+        resp = await c.post("/kx/printers/1/power", json={"action": "on"})
+        assert resp.status == 400
+
+
+@pytest.mark.asyncio
+async def test_power_switch_unreachable_returns_502(power_client):
+    c, bridge = power_client
+    with patch("aiohttp.ClientSession.get", side_effect=OSError("connection refused")):
+        resp = await c.post("/kx/printers/1/power", json={"action": "on"})
+    assert resp.status == 502
+
+
+@pytest.mark.asyncio
+async def test_power_status_parses_tasmota_json(power_client):
+    c, bridge = power_client
+    with patch("aiohttp.ClientSession.get", return_value=_fake_get_response(200, '{"POWER":"ON"}')):
+        resp = await c.get("/kx/printers/1/power-status")
+        data = await resp.json()
+    assert data["state"] == "on"
+
+
+@pytest.mark.asyncio
+async def test_power_status_parses_tasmota_json_off(power_client):
+    c, bridge = power_client
+    with patch("aiohttp.ClientSession.get", return_value=_fake_get_response(200, '{"POWER":"OFF"}')):
+        resp = await c.get("/kx/printers/1/power-status")
+        data = await resp.json()
+    assert data["state"] == "off"
+
+
+@pytest.mark.asyncio
+async def test_power_status_falls_back_to_plain_text(power_client):
+    c, bridge = power_client
+    with patch("aiohttp.ClientSession.get", return_value=_fake_get_response(200, "STATE: ON")):
+        resp = await c.get("/kx/printers/1/power-status")
+        data = await resp.json()
+    assert data["state"] == "on"
+
+
+@pytest.mark.asyncio
+async def test_power_status_missing_url_configured_error():
+    bridge = _make_bridge()  # no power_status_url set
+    app = build_app(bridge)
+    async with TestClient(TestServer(app)) as c:
+        resp = await c.get("/kx/printers/1/power-status")
+        assert resp.status == 400
+
+
+@pytest.mark.asyncio
+async def test_settings_roundtrip_persists_power_urls(power_client):
+    c, bridge = power_client
+    resp = await c.get("/api/settings")
+    data = await resp.json()
+    assert data["power_on_url"] == "http://192.168.1.99/cm?cmnd=Power%20on"
+    assert data["power_off_url"] == "http://192.168.1.99/cm?cmnd=Power%20off"
+    assert data["power_status_url"] == "http://192.168.1.99/cm?cmnd=Power"

tests/test_settings.py

@@ -40,14 +40,23 @@ async def test_settings_get_returns_configured_values(client_configured):
 
 
 @pytest.mark.asyncio
-async def test_settings_post_writes_env(client):
-    """POST /api/settings schreibt Werte in .env-Datei."""
+async def test_settings_post_invalid_json_returns_400(client):
+    """A malformed/non-JSON body must be a clean 400, not an unhandled 500
+    with a raw JSONDecodeError traceback (code review finding)."""
+    c, _ = client
+    resp = await c.post("/api/settings", data=b"not json", headers={"Content-Type": "application/json"})
+    assert resp.status == 400
+
+
+@pytest.mark.asyncio
+async def test_settings_post_writes_config_ini(client):
+    """POST /api/settings schreibt Werte in config.ini (Migration von .env, v0.9.x)."""
     c, bridge = client
 
     with tempfile.TemporaryDirectory() as tmpdir:
-        env_path = pathlib.Path(tmpdir) / ".env"
-        env_path.write_text("")
-        bridge._find_env_path = lambda: env_path
+        config_path = pathlib.Path(tmpdir) / "config.ini"
+        bridge._find_config_path = lambda: config_path
+        bridge._restart_bridge = lambda: None  # POST triggers a restart — don't kill the test process
 
         resp = await c.post("/api/settings", json={
             "printer_ip": "10.0.0.5",
@@ -59,24 +68,28 @@ async def test_settings_post_writes_env(client):
         })
         assert resp.status == 200
 
-        content = env_path.read_text()
-        assert "PRINTER_IP=10.0.0.5"          in content
-        assert "MQTT_USERNAME=userABCD"        in content
-        assert "DEVICE_ID=deadbeef01234567"    in content
+        content = config_path.read_text()
+        assert "printer_ip = 10.0.0.5"       in content
+        assert "username = userABCD"         in content
+        assert "device_id = deadbeef01234567" in content
 
 
 @pytest.mark.asyncio
 async def test_settings_post_preserves_existing_keys(client):
-    """POST darf unbekannte Keys in .env nicht löschen (z.B. GITEA_TOKEN)."""
+    """POST darf unbekannte Sections/Optionen in config.ini nicht löschen (z.B. Spoolman-Server)."""
     c, bridge = client
 
     with tempfile.TemporaryDirectory() as tmpdir:
-        env_path = pathlib.Path(tmpdir) / ".env"
-        env_path.write_text("GITEA_TOKEN=mytoken\nPRINTER_IP=old\n")
-        bridge._find_env_path = lambda: env_path
+        config_path = pathlib.Path(tmpdir) / "config.ini"
+        config_path.write_text(
+            "[spoolman]\nserver = http://192.168.1.50:7912\n\n"
+            "[connection]\nprinter_ip = old\n"
+        )
+        bridge._find_config_path = lambda: config_path
+        bridge._restart_bridge = lambda: None
 
         await c.post("/api/settings", json={"printer_ip": "10.0.0.99"})
 
-        content = env_path.read_text()
-        assert "GITEA_TOKEN=mytoken" in content
-        assert "PRINTER_IP=10.0.0.99" in content
+        content = config_path.read_text()
+        assert "server = http://192.168.1.50:7912" in content
+        assert "printer_ip = 10.0.0.99" in content

tests/test_slot_profile_material_guard.py

@@ -0,0 +1,157 @@
+"""Stale slot-profile guard: suppress a saved per-slot filament profile when the
+AMS now reports a *different material family* than the profile was assigned for.
+
+Real-world bug (KX1): slot 1 held a PETG spool and got the profile
+"KINGROON PETG Basic". The user swapped in yellow PLA. The AMS updated the
+colour (live) but the saved profile stuck on PETG, so the panel + the slicer
+hint kept showing/using PETG. Restarting did not help — the override lives in
+config.ini.
+
+Fix = non-destructive suppression (Option A): resolve the effective profile as
+"the saved override only if its material *family* matches the current AMS
+material; otherwise none (fall back to the generic default)". The override is
+never deleted, so putting the original material back reactivates it.
+
+Comparison must be by *family*, never strict string equality — PLA / PLA+ /
+PLA SILK / PLA MATTE are the same family and must NOT invalidate each other
+(regression guard for the earlier over-strict material compare).
+"""
+import argparse
+import json
+import tempfile
+from unittest.mock import MagicMock
+
+# conftest.py (same dir) already put bridge/ on sys.path and mocked env_loader.
+from kobrax_moonraker_bridge import KobraXBridge
+
+# Minimal in-memory stand-in for orca_filaments.json (id, name, vendor, type).
+LIBRARY = [
+    {"vendor": "KINGROON", "name": "KINGROON PETG Basic",      "type": "PETG", "id": "PB01"},
+    {"vendor": "KINGROON", "name": "KINGROON PLA Basic",       "type": "PLA",  "id": "PL01"},
+    {"vendor": "XTZL3D",   "name": "XTZL3D Speedy Silk PLA+",  "type": "PLA",  "id": "PS01"},
+]
+
+PETG_PROFILE = {"vendor": "KINGROON", "name": "KINGROON PETG Basic", "id": "PB01"}
+SILK_PROFILE = {"vendor": "XTZL3D",   "name": "XTZL3D Speedy Silk PLA+", "id": "PS01"}
+UNKNOWN_PROFILE = {"vendor": "Foo", "name": "Foo Bar Filament", "id": "X99"}
+
+
+def _bridge():
+    c = MagicMock()
+    c.callbacks = {}
+    c.connected = False
+    args = argparse.Namespace(
+        printer_ip="", mqtt_port=9883, username="", password="",
+        mode_id="20030", device_id="", host="127.0.0.1", port=7125,
+        data_dir=tempfile.mkdtemp(prefix="kxguard-"),
+    )
+    b = KobraXBridge(c, args=args)
+    b._orca_filaments_cache = LIBRARY  # _load_orca_filaments() returns this as-is
+    return b
+
+
+# ── _material_family ──────────────────────────────────────────────────────────
+
+def test_material_family_collapses_pla_variants():
+    fam = KobraXBridge._material_family
+    assert fam("PLA") == "PLA"
+    assert fam("PLA+") == "PLA"
+    assert fam("PLA SILK") == "PLA"
+    assert fam("PLA MATTE") == "PLA"
+    assert fam("Silk PLA") == "PLA"  # alias-normalised before family reduction
+
+
+def test_material_family_collapses_petg_variants():
+    fam = KobraXBridge._material_family
+    assert fam("PETG") == "PETG"
+    assert fam("PETG+") == "PETG"
+
+
+def test_material_family_distinguishes_pla_from_petg():
+    fam = KobraXBridge._material_family
+    assert fam("PLA") != fam("PETG")
+    assert fam("PLA SILK") != fam("PETG")
+
+
+def test_material_family_empty_for_empty_input():
+    assert KobraXBridge._material_family("") == ""
+    assert KobraXBridge._material_family(None) == ""
+
+
+# ── _effective_slot_profile ───────────────────────────────────────────────────
+
+def test_suppressed_when_family_changes_petg_profile_pla_loaded():
+    """The exact KX1 bug: PETG profile, AMS now reports PLA → suppress."""
+    b = _bridge()
+    b._filament_profiles = {0: dict(PETG_PROFILE)}
+    assert b._effective_slot_profile(0, "PLA") == {}
+
+
+def test_kept_when_family_matches_petg_profile_petg_loaded():
+    b = _bridge()
+    b._filament_profiles = {0: dict(PETG_PROFILE)}
+    assert b._effective_slot_profile(0, "PETG") == PETG_PROFILE
+
+
+def test_kept_for_pla_variant_no_false_positive():
+    """PLA+ profile with a PLA SILK spool loaded is the same family → keep."""
+    b = _bridge()
+    b._filament_profiles = {1: dict(SILK_PROFILE)}
+    assert b._effective_slot_profile(1, "PLA SILK") == SILK_PROFILE
+
+
+def test_kept_when_profile_material_unknown_failsafe():
+    """If the profile is not in the library we cannot know its family → never
+    suppress on uncertainty (fail-safe keeps the user's choice)."""
+    b = _bridge()
+    b._filament_profiles = {2: dict(UNKNOWN_PROFILE)}
+    assert b._effective_slot_profile(2, "PLA") == UNKNOWN_PROFILE
+
+
+def test_empty_when_no_override():
+    b = _bridge()
+    b._filament_profiles = {}
+    assert b._effective_slot_profile(3, "PLA") == {}
+
+
+# ── Integration: display endpoint (the visible panel) ─────────────────────────
+
+async def test_display_endpoint_suppresses_stale_petg_when_pla_loaded():
+    """/kx/filament/slots must not show the stale PETG identity once PLA loads."""
+    b = _bridge()
+    b._ams_slots = [{"global_index": 0, "status": 5, "color": [255, 236, 61], "type": "PLA"}]
+    b._filament_profiles = {0: dict(PETG_PROFILE)}
+    row = json.loads((await b.handle_kx_filament_slots(MagicMock())).body)["result"][0]
+    assert row["material"] == "PLA"        # AMS truth, always
+    assert row["filament_name"] == ""      # stale PETG identity gone
+    assert row["filament_vendor"] == ""
+
+
+async def test_display_endpoint_keeps_profile_when_family_matches():
+    b = _bridge()
+    b._ams_slots = [{"global_index": 0, "status": 5, "color": [10, 20, 30], "type": "PETG"}]
+    b._filament_profiles = {0: dict(PETG_PROFILE)}
+    row = json.loads((await b.handle_kx_filament_slots(MagicMock())).body)["result"][0]
+    assert row["filament_name"] == "KINGROON PETG Basic"
+    assert row["filament_vendor"] == "KINGROON"
+
+
+# ── Integration: print path (lane_data sent to OrcaSlicer) ────────────────────
+
+async def test_lane_data_does_not_leak_stale_petg_identity():
+    b = _bridge()
+    b._ams_slots = [{"status": 5, "color": [255, 236, 61], "type": "PLA"}]
+    b._filament_profiles = {0: dict(PETG_PROFILE)}
+    tray = b._build_lane_data()["ams"][0]["tray"][0]
+    assert tray["tray_type"] == "PLA"
+    assert "PETG" not in tray["name"].upper()
+    assert tray["vendor_name"] != "KINGROON"
+
+
+async def test_lane_data_keeps_profile_when_family_matches():
+    b = _bridge()
+    b._ams_slots = [{"status": 5, "color": [10, 20, 30], "type": "PETG"}]
+    b._filament_profiles = {0: dict(PETG_PROFILE)}
+    tray = b._build_lane_data()["ams"][0]["tray"][0]
+    assert tray["name"] == "KINGROON PETG Basic"
+    assert tray["vendor_name"] == "KINGROON"

tests/test_spoolman_slot_map.py

@@ -0,0 +1,100 @@
+"""Per-printer Spoolman slot-map isolation + persistence (config_loader).
+
+Regression test for two bugs in the Spoolman slot→spool persistence:
+
+  1. The bridge referenced ``config_loader`` while the module alias is
+     ``env_loader`` → ``NameError`` swallowed by a bare ``except``, so the map
+     was never loaded nor saved (persistence looked implemented but was dead).
+  2. The map lived in a single global ``[spoolman] slot_spools`` key, so two
+     printers/two AMS units overwrote each other (same class as issue #74/#75).
+
+Each printer now uses its own ``[spoolman_<id>]`` section, with a read-fallback
+to the legacy global key for backward compatibility. The global ``[spoolman]``
+section keeps ``server`` / ``sync_rate``.
+"""
+import sys
+import pathlib
+import configparser
+
+sys.path.insert(0, str(pathlib.Path(__file__).resolve().parent.parent))  # repo root
+import config_loader  # noqa: E402
+
+BASE_INI = (
+    "[printer_1]\nname = K1\n\n"
+    "[printer_2]\nname = K2\n\n"
+    "[spoolman]\n"
+    "server = http://192.168.3.200:7912\n"
+    "sync_rate = 0\n"
+    "slot_spools = 0:1,1:2\n"
+)
+
+
+def _use_ini(monkeypatch, tmp_path, text=BASE_INI):
+    path = tmp_path / "config.ini"
+    path.write_text(text, encoding="utf-8")
+    monkeypatch.setattr(config_loader, "_find_config_file", lambda: path)
+    return path
+
+
+def test_legacy_global_read(tmp_path, monkeypatch):
+    """No printer_id -> original global [spoolman] slot_spools (back-compat)."""
+    _use_ini(monkeypatch, tmp_path)
+    assert config_loader.list_spool_map() == {0: 1, 1: 2}
+
+
+def test_read_falls_back_to_global_until_first_save(tmp_path, monkeypatch):
+    """Before any per-printer save, both printers see the global mapping."""
+    _use_ini(monkeypatch, tmp_path)
+    assert config_loader.list_spool_map("1") == {0: 1, 1: 2}
+    assert config_loader.list_spool_map("2") == {0: 1, 1: 2}
+
+
+def test_saving_one_printer_does_not_touch_the_other(tmp_path, monkeypatch):
+    """Core regression: mapping printer 1 must not change printer 2."""
+    _use_ini(monkeypatch, tmp_path)
+    config_loader.save_spool_map({0: 42, 1: 17}, "1")
+    assert config_loader.list_spool_map("1") == {0: 42, 1: 17}
+    # printer 2 has no own section yet -> still the global fallback
+    assert config_loader.list_spool_map("2") == {0: 1, 1: 2}
+    # legacy global key preserved untouched
+    assert config_loader.list_spool_map() == {0: 1, 1: 2}
+
+
+def test_both_printers_isolated_after_each_saves(tmp_path, monkeypatch):
+    _use_ini(monkeypatch, tmp_path)
+    config_loader.save_spool_map({0: 42, 1: 17}, "1")
+    config_loader.save_spool_map({0: 5, 1: 6}, "2")
+    assert config_loader.list_spool_map("1") == {0: 42, 1: 17}
+    assert config_loader.list_spool_map("2") == {0: 5, 1: 6}
+
+
+def test_save_preserves_server_and_sync_rate(tmp_path, monkeypatch):
+    """Writing a per-printer map must not clobber [spoolman] server/sync_rate."""
+    path = _use_ini(monkeypatch, tmp_path)
+    config_loader.save_spool_map({0: 42}, "1")
+    cfg = configparser.ConfigParser()
+    cfg.read(path, encoding="utf-8")
+    assert cfg.get("spoolman", "server") == "http://192.168.3.200:7912"
+    assert cfg.get("spoolman", "sync_rate") == "0"
+    assert cfg.get("spoolman_1", "slot_spools") == "0:42"
+
+
+def test_persistence_round_trips(tmp_path, monkeypatch):
+    """Save then read back (simulates a bridge restart) — the map survives."""
+    _use_ini(monkeypatch, tmp_path, text="[spoolman]\nserver = http://x:7912\n")
+    config_loader.save_spool_map({0: 7, 2: 9}, "1")
+    assert config_loader.list_spool_map("1") == {0: 7, 2: 9}
+
+
+def test_empty_map_clears_the_key(tmp_path, monkeypatch):
+    _use_ini(monkeypatch, tmp_path)
+    config_loader.save_spool_map({0: 42}, "1")
+    config_loader.save_spool_map({}, "1")            # clear
+    # per-printer key gone -> falls back to the legacy global map
+    assert config_loader.list_spool_map("1") == {0: 1, 1: 2}
+
+
+def test_parse_ignores_malformed_and_nonpositive(tmp_path, monkeypatch):
+    _use_ini(monkeypatch, tmp_path,
+             text="[spoolman]\nslot_spools = 0:1, x:y, 2:0, 3:-4, 4:5, junk\n")
+    assert config_loader.list_spool_map() == {0: 1, 4: 5}

tests/test_tcp_keepalive.py

@@ -0,0 +1,80 @@
+"""TCP keepalive + TCP_USER_TIMEOUT on the MQTT socket (Issue #103 follow-up).
+
+Without these, a printer that disappears without a clean TCP close
+(unplugged, not gracefully shut down) leaves the socket looking alive to
+is_connected() for as long as the OS's default dead-connection timeout -
+often 15+ minutes on Linux - since sendall() on a half-open connection is
+buffered by the kernel and doesn't fail immediately. This left the
+dashboard's printer-state indicator stuck showing the last known state
+(e.g. green "ready") long after the printer was actually unreachable,
+reported when testing the smart-plug power-switch feature by physically
+unplugging the printer.
+
+Verified live (real printer, physically unplugged) that SO_KEEPALIVE alone
+is not sufficient: keepalive probes only fire on an idle connection, but if
+the printer disappears while a send is still unacknowledged - the normal
+case, since the poll loop is sending every few seconds - the kernel's
+regular TCP retransmission timer takes over instead (tcp_retries2, 13-30+
+minutes on Linux), which keepalive settings don't affect. TCP_USER_TIMEOUT
+closes that gap by capping how long ANY unacknowledged data may sit in the
+send queue, regardless of which retry mechanism would otherwise still be
+running.
+"""
+import socket
+from unittest.mock import MagicMock
+
+import pytest
+
+from kobrax_client import _enable_tcp_keepalive
+
+
+def test_enable_tcp_keepalive_sets_so_keepalive():
+    s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+    try:
+        _enable_tcp_keepalive(s)
+        assert s.getsockopt(socket.SOL_SOCKET, socket.SO_KEEPALIVE) == 1
+    finally:
+        s.close()
+
+
+@pytest.mark.skipif(not hasattr(socket, "TCP_KEEPIDLE"), reason="Linux-specific option")
+def test_enable_tcp_keepalive_sets_short_idle_and_interval():
+    s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+    try:
+        _enable_tcp_keepalive(s)
+        idle = s.getsockopt(socket.IPPROTO_TCP, socket.TCP_KEEPIDLE)
+        intvl = s.getsockopt(socket.IPPROTO_TCP, socket.TCP_KEEPINTVL)
+        cnt = s.getsockopt(socket.IPPROTO_TCP, socket.TCP_KEEPCNT)
+        # Short enough that a dead connection is detected within a couple of
+        # poll cycles (default poll_interval is 3s), not the OS default of
+        # minutes.
+        assert idle <= 10
+        assert intvl <= 5
+        assert cnt <= 5
+    finally:
+        s.close()
+
+
+@pytest.mark.skipif(not hasattr(socket, "TCP_USER_TIMEOUT"), reason="Linux-specific option")
+def test_enable_tcp_keepalive_sets_user_timeout():
+    """The critical fix, verified live against a real printer: without this,
+    a dead connection with unacknowledged data in flight is only detected
+    after the OS's normal TCP retransmission timeout (13-30+ minutes on
+    Linux), not the keepalive interval."""
+    s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+    try:
+        _enable_tcp_keepalive(s)
+        user_timeout_ms = s.getsockopt(socket.IPPROTO_TCP, socket.TCP_USER_TIMEOUT)
+        # Short enough that a dead connection with in-flight data is detected
+        # within a couple of poll cycles, not tens of minutes.
+        assert 0 < user_timeout_ms <= 20000
+    finally:
+        s.close()
+
+
+def test_enable_tcp_keepalive_does_not_raise_on_unsupported_platform():
+    """A platform without TCP_KEEPIDLE/INTVL/CNT (e.g. some Windows builds)
+    must not crash the connection attempt - keepalive is best-effort."""
+    s = MagicMock()
+    s.setsockopt.side_effect = OSError("unsupported")
+    _enable_tcp_keepalive(s)  # must not raise

tests/test_update_check.py

@@ -0,0 +1,100 @@
+"""Update-check regression for Issue #104.
+
+STABLE_RELEASE_API used limit=1, so it only ever saw the single newest
+release on Gitea regardless of type. Since nightly/dev prereleases publish
+far more often than stable releases, that newest release is almost always a
+prerelease - the stable_releases filter (not prerelease) then found nothing
+and /api/update/check returned "no stable releases found" even though older
+stable releases exist.
+"""
+from unittest.mock import AsyncMock, MagicMock, patch
+
+import pytest
+
+
+@pytest.mark.asyncio
+async def test_update_apply_invalid_json_returns_400(client):
+    """A malformed/non-JSON body must be a clean 400, not an unhandled 500
+    with a raw JSONDecodeError traceback (code review finding)."""
+    c, _ = client
+    resp = await c.post("/api/update/apply", data=b"not json", headers={"Content-Type": "application/json"})
+    assert resp.status == 400
+
+
+@pytest.mark.asyncio
+async def test_update_check_testing_channel_is_docker_only(client):
+    """A testing-<sha> build has no Gitea releases at all - the check must
+    report a docker-only channel with nothing to update, NOT fall through to
+    the stable path and wrongly offer a stable "update". Must not even call
+    the Gitea API."""
+    c, bridge = client
+    bridge._read_version = lambda: "testing-2e4dbf0"
+
+    with patch("aiohttp.ClientSession.get") as mock_get:
+        resp = await c.get("/api/update/check")
+        data = await resp.json()
+
+    assert resp.status == 200
+    assert data["update_available"] is False
+    assert data["docker_only"] is True
+    assert data["current"] == "testing-2e4dbf0"
+    mock_get.assert_not_called()  # no Gitea round-trip for the testing channel
+
+
+@pytest.mark.asyncio
+async def test_update_apply_testing_channel_blocked(client):
+    """Self-update must be refused on the testing channel, same as nightly -
+    testing images are delivered via Docker only."""
+    c, bridge = client
+    bridge._read_version = lambda: "testing-2e4dbf0"
+
+    resp = await c.post("/api/update/apply", json={"tag": "whatever"})
+    data = await resp.json()
+    assert resp.status == 400
+    assert "testing" in data["error"]
+    assert "docker" in data["error"].lower()
+
+
+def _fake_releases_response(payload):
+    resp = MagicMock()
+    resp.status = 200
+    resp.json = AsyncMock(return_value=payload)
+    ctx = MagicMock()
+    ctx.__aenter__ = AsyncMock(return_value=resp)
+    ctx.__aexit__ = AsyncMock(return_value=False)
+    return ctx
+
+
+@pytest.mark.asyncio
+async def test_stable_update_check_finds_release_behind_newer_prereleases(client):
+    c, bridge = client
+    bridge._read_version = lambda: "0.9.27"
+
+    releases = (
+        [{"tag_name": f"nightly-0.9.30-nightly{i}", "prerelease": True} for i in range(1, 7)]
+        + [{"tag_name": "v0.9.29", "prerelease": False, "body": "changelog"}]
+    )
+
+    with patch("aiohttp.ClientSession.get", return_value=_fake_releases_response(releases)):
+        resp = await c.get("/api/update/check")
+        data = await resp.json()
+
+    assert resp.status == 200
+    assert data["latest"] == "0.9.29"
+    assert data["update_available"] is True
+
+
+@pytest.mark.asyncio
+async def test_stable_update_check_requests_enough_releases_to_skip_prereleases(client):
+    """The API URL itself must ask for more than the single newest release -
+    a limit=1 request can never find a stable release behind a run of
+    prereleases no matter how the response is parsed."""
+    c, bridge = client
+    bridge._read_version = lambda: "0.9.27"
+
+    import re
+    assert not re.search(r"limit=1(?!\d)", bridge.STABLE_RELEASE_API), (
+        "STABLE_RELEASE_API must request more than 1 release, otherwise a "
+        "recent nightly/dev prerelease being the newest release hides all "
+        "stable releases behind it (Issue #104)"
+    )

web/themes/default/index.html

@@ -5,9 +5,14 @@
 <meta name="viewport" content="width=device-width,initial-scale=1">
 <title>KX-Bridge</title>
 <link rel="stylesheet" href="/kx/ui/style.css">
+<link rel="stylesheet" href="/kx/ui/lib/pickr-nano.min.css">
+<link rel="stylesheet" href="/kx/ui/lib/gridstack.min.css">
+<script src="/kx/ui/lib/pickr.min.js"></script>
+<script src="/kx/ui/lib/gridstack-all.min.js"></script>
 <body>
 
 <div id="conn-error-banner" style="display:none;background:#c0392b;color:#fff;padding:10px 18px;font-size:14px;text-align:center;position:sticky;top:0;z-index:999;"></div>
+<div id="pause-msg-banner" style="display:none;background:#b8860b;color:#fff;padding:10px 18px;font-size:14px;text-align:center;position:sticky;top:0;z-index:997;"></div>
 <div id="file-ready-banner" style="display:none;background:#1a6e3c;color:#fff;padding:10px 18px;font-size:14px;text-align:center;position:sticky;top:0;z-index:998;display:none;align-items:center;justify-content:center;gap:12px;flex-wrap:wrap">
   <span>📄 <span id="file-ready-name"></span></span>
   <button id="file-ready-btn" onclick="startReadyFile()"
@@ -32,17 +37,6 @@
   <span id="h-version" style="font-size:11px;opacity:.5;margin-left:6px"></span>
   <div class="hbadge" id="h-badge"><span class="dot"></span><span id="h-state">Standby</span></div>
   <button class="theme-btn" onclick="toggleTheme()">☀ / ☾</button>
-  <div style="display:flex;align-items:center;gap:6px">
-    <span aria-hidden="true" style="font-size:15px;line-height:1;opacity:.85">🌐</span>
-    <select class="theme-btn" id="lang-select" onchange="setLanguageFromSelect()" style="padding:6px 10px">
-      <option value="de">Deutsch</option>
-      <option value="en">English</option>
-      <option value="es">Espanol</option>
-      <option value="fr">Français</option>
-      <option value="it">Italiano</option>
-      <option value="zh-cn">中文(简体)</option>
-    </select>
-  </div>
   <button class="theme-btn" onclick="showPanel('settings')" id="settings-btn" title="Einstellungen">⚙</button>
   <button class="conn-btn disconnected" id="conn-btn" onclick="toggleConnection()">⚡ Verbinden</button>
 </header>
@@ -57,15 +51,26 @@
       <span class="modal-title" id="slot-edit-title"></span>
       <button onclick="closeSlotEdit()" style="background:none;border:none;color:var(--txt2);font-size:20px;cursor:pointer;line-height:1">✕</button>
     </div>
-    <div style="display:flex;align-items:center;gap:16px;margin-bottom:20px">
-      <div id="slot-edit-preview" style="width:56px;height:56px;border-radius:50%;border:3px solid rgba(255,255,255,.2);flex-shrink:0"></div>
-      <div style="flex:1">
-        <div style="font-size:11px;color:var(--txt2);margin-bottom:4px" id="lbl-slot-color"></div>
-        <input type="color" id="slot-edit-color"
-          oninput="document.getElementById('slot-edit-preview').style.background=this.value"
-          style="width:100%;height:36px;border:1px solid var(--border);border-radius:6px;background:var(--raised);cursor:pointer;padding:2px">
+    <div style="display:flex;align-items:flex-start;gap:16px;margin-bottom:12px">
+      <div id="slot-edit-preview" style="width:56px;height:56px;border-radius:50%;border:3px solid rgba(255,255,255,.2);flex-shrink:0;margin-top:4px"></div>
+      <div style="flex:1;min-width:0">
+        <div style="font-size:11px;color:var(--txt2);margin-bottom:6px" id="lbl-slot-color"></div>
+        <!-- Pickr anchor — JS mounts the picker here -->
+        <div id="slot-pickr-anchor"></div>
+        <!-- hidden input keeps the hex value for saveSlotEdit() -->
+        <input type="hidden" id="slot-edit-color">
       </div>
     </div>
+    <!-- Recent color swatches (max 16, localStorage) -->
+    <div id="slot-color-swatches" style="display:flex;gap:5px;flex-wrap:wrap;margin-bottom:8px"></div>
+    <!-- Copy from slot -->
+    <div id="slot-copy-row" style="display:none;margin-bottom:16px">
+      <select id="slot-copy-select"
+        style="width:100%;padding:5px 8px;background:var(--raised);border:1px solid var(--border);border-radius:6px;color:var(--txt);font-size:12px;box-sizing:border-box"
+        onchange="slotCopyColor(this)">
+        <option value="" id="lbl-slot-copy-from">Copy color from slot…</option>
+      </select>
+    </div>
     <div style="margin-bottom:20px">
       <div style="font-size:11px;color:var(--txt2);margin-bottom:6px" id="lbl-slot-material"></div>
       <div style="display:flex;flex-wrap:wrap;gap:6px" id="slot-mat-btns">
@@ -135,9 +140,19 @@
   <main>
     <!-- ═══ DASHBOARD ═══ -->
     <div class="panel active" id="panel-dashboard">
-      <div class="grid">
+      <div id="dash-toolbar" style="display:flex;justify-content:flex-end;align-items:center;gap:8px;margin-bottom:10px">
+        <select id="dash-preset" onchange="applyDashPreset(this.value)" style="display:none;padding:4px 8px;font-size:12px;background:var(--raised);color:var(--txt);border:1px solid var(--border);border-radius:6px">
+          <option value="standard" id="dash-preset-standard">Standard</option>
+          <option value="wide89" id="dash-preset-wide89">Desktop breit</option>
+        </select>
+        <button id="dash-preset-delete-btn" onclick="deleteCurrentDashPreset()" style="display:none;padding:4px 10px;font-size:12px;background:var(--raised);color:var(--err);border:1px solid var(--border);border-radius:6px;cursor:pointer">🗑</button>
+        <button id="dash-preset-save-btn" onclick="saveCurrentAsDashPreset()" style="display:none;padding:4px 10px;font-size:12px;background:var(--raised);color:var(--txt2);border:1px solid var(--border);border-radius:6px;cursor:pointer">💾 <span id="dash-lbl-save-preset">Als Preset speichern</span></button>
+        <button id="dash-reset-btn" onclick="resetDashLayout()" style="display:none;padding:4px 10px;font-size:12px;background:var(--raised);color:var(--txt2);border:1px solid var(--border);border-radius:6px;cursor:pointer">↺ <span id="dash-lbl-reset">Zurücksetzen</span></button>
+        <button id="dash-edit-btn" onclick="toggleDashEdit()" style="padding:4px 10px;font-size:12px;background:var(--raised);color:var(--txt2);border:1px solid var(--border);border-radius:6px;cursor:pointer">🖉 <span id="dash-lbl-edit">Dashboard anpassen</span></button>
+      </div>
+      <div class="grid-stack" id="dash-grid">
         <!-- Kamera -->
-        <div class="card" style="grid-column:1/-1">
+        <div class="card" id="card-camera" data-card="camera" gs-w="12" gs-h="7">
           <div style="display:flex;align-items:center;justify-content:space-between;margin-bottom:10px">
             <div class="card-title" style="margin-bottom:0"><span>📷</span> <span id="d-card-cam">Kamera</span></div>
             <div style="display:flex;align-items:center;gap:10px">
@@ -152,7 +167,7 @@
           <div class="cam-wrap" id="cam-wrap">
             <div class="cam-placeholder" id="cam-placeholder"><span id="cam-placeholder-txt">📷 Kamera nicht gestartet</span></div>
             <div class="cam-spinner" id="cam-spinner"></div>
-            <img id="cam-img" style="display:none;width:100%;height:auto" alt="Kamera">
+            <img id="cam-img" draggable="false" style="display:none;width:100%;height:auto" alt="Kamera">
             <div class="cam-overlay" id="cam-overlay" style="display:none">
               <div style="font-size:12px;color:#fff" id="cam-fname"></div>
             </div>
@@ -162,7 +177,7 @@
         </div>
 
         <!-- Fortschritt -->
-        <div class="card" style="grid-column:1/-1">
+        <div class="card" id="card-progress" data-card="progress" gs-w="12" gs-h="6">
           <div class="card-title"><span>◉</span> <span id="d-card-progress">Fortschritt</span></div>
           <img id="d-thumbnail" src="" alt="" style="display:none;width:100%;max-height:160px;object-fit:contain;border-radius:8px;background:#111;margin-bottom:10px">
           <div class="pct-big"><span id="d-pct">0</span><small>%</small></div>
@@ -208,7 +223,7 @@
         </div>
 
         <!-- Temperatursteuerung + Verlauf -->
-        <div class="card" style="grid-column:1/-1">
+        <div class="card" id="card-temps" data-card="temps" gs-w="6" gs-h="7">
           <div class="card-title"><span>⊙</span> <span id="d-card-temps">Temperaturen</span></div>
           <div class="temp-card-inner">
             <div class="temp-block">
@@ -251,43 +266,55 @@
         </div>
 
         <!-- Achsensteuerung -->
-        <div class="card">
-          <div class="card-title"><span>✛</span> <span id="ptitle-motion-xy">XY-Achsen</span></div>
-          <div class="joypad">
-            <div></div>
-            <button class="joy" onclick="move(1,1,getStep())" title="Y+">▲</button>
-            <div></div>
-            <button class="joy" onclick="move(0,-1,getStep())" title="X−">◀</button>
-            <button class="joy home" onclick="homeAll()" title="Home All">⌂</button>
-            <button class="joy" onclick="move(0,1,getStep())" title="X+">▶</button>
-            <div></div>
-            <button class="joy" onclick="move(1,-1,getStep())" title="Y−">▼</button>
-            <div></div>
+        <div class="card" id="card-motion" data-card="motion" gs-w="6" gs-h="7">
+          <div class="card-title"><span>✛</span> <span id="ptitle-motion-xy">Achsensteuerung</span></div>
+          <div style="display:flex;gap:16px;align-items:flex-start;flex-wrap:wrap">
+            <!-- XY -->
+            <div style="display:flex;flex-direction:column;align-items:center;gap:6px">
+              <div class="joypad">
+                <div></div>
+                <button class="joy" onclick="move(1,1,getStep())" title="Y+">▲</button>
+                <div></div>
+                <button class="joy" onclick="move(0,-1,getStep())" title="X−">◀</button>
+                <div></div>
+                <button class="joy" onclick="move(0,1,getStep())" title="X+">▶</button>
+                <div></div>
+                <button class="joy" onclick="move(1,-1,getStep())" title="Y−">▼</button>
+                <div></div>
+              </div>
+              <button class="btn btn-sm" style="background:var(--raised);color:var(--txt);width:100%" onclick="homeXY()"><span class="lbl-home-xy">Home XY</span></button>
+            </div>
+            <!-- Z -->
+            <div style="display:flex;flex-direction:column;align-items:center;gap:6px">
+              <div class="joypad" style="grid-template-columns:52px;grid-template-rows:repeat(2,52px)">
+                <button class="joy" onclick="move(2,1,getStep())" title="Z+">▲</button>
+                <button class="joy" onclick="move(2,-1,getStep())" title="Z−">▼</button>
+              </div>
+              <button class="btn btn-sm" style="background:var(--raised);color:var(--txt);width:100%" onclick="homeZ()"><span class="lbl-home-z">Home Z</span></button>
+            </div>
           </div>
-          <div class="step-btns">
-            <button class="step-btn" onclick="setStep(this,0.1)">0.1</button>
-            <button class="step-btn active" onclick="setStep(this,1)">1</button>
-            <button class="step-btn" onclick="setStep(this,5)">5</button>
-            <button class="step-btn" onclick="setStep(this,10)">10 mm</button>
+          <!-- Einheitliche Step-Size -->
+          <div style="display:flex;align-items:center;gap:6px;margin-top:10px;flex-wrap:wrap">
+            <div class="step-btns" style="margin-top:0">
+              <button class="step-btn" onclick="setStep(this,0.1)">0.1</button>
+              <button class="step-btn active" onclick="setStep(this,1)">1</button>
+              <button class="step-btn" onclick="setStep(this,5)">5</button>
+              <button class="step-btn" onclick="setStep(this,10)">10</button>
+            </div>
+            <input id="step-custom" type="number" min="0.1" max="260" step="0.1"
+              placeholder="mm"
+              style="width:60px;padding:4px 6px;font-size:12px;border-radius:6px;border:1px solid var(--border);background:var(--raised);color:var(--txt);text-align:center"
+              oninput="setStepCustom(this)">
           </div>
-          <div class="home-btns">
-            <button class="btn btn-sm" style="background:var(--raised);color:var(--txt)" onclick="homeZ()"><span class="lbl-home-z">Home Z</span></button>
-            <button class="btn btn-sm" style="background:var(--raised);color:var(--txt)" onclick="homeXY()"><span class="lbl-home-xy">Home XY</span></button>
+          <!-- Globale Befehle zentriert -->
+          <div style="display:flex;justify-content:center;gap:8px;margin-top:10px">
             <button class="btn btn-sm btn-accent" onclick="homeAll()"><span class="lbl-home-all">Home All</span></button>
             <button class="btn btn-sm" style="background:var(--raised);color:var(--txt)" onclick="disableMotors()"><span class="lbl-disable-motors">Motors Off</span></button>
           </div>
         </div>
-        <div class="card">
-          <div class="card-title"><span>↕</span> <span id="ptitle-motion-z">Z-Achse</span></div>
-          <div class="joypad" style="grid-template-columns:52px;grid-template-rows:repeat(2,52px)">
-            <button class="joy" onclick="move(2,1,getStep())" title="Z+">▲</button>
-            <button class="joy" onclick="move(2,-1,getStep())" title="Z−">▼</button>
-          </div>
-          <div style="text-align:center;margin-top:8px;font-size:12px;color:var(--txt2)"><span class="lbl-step">Schrittweite:</span> <span id="step-display">1</span> mm</div>
-        </div>
 
         <!-- Print Speed -->
-        <div class="card">
+        <div class="card" id="card-speed" data-card="speed" gs-w="6" gs-h="3">
           <div class="card-title"><span>🏎</span> <span id="d-card-speed">Druckgeschwindigkeit</span></div>
           <div style="display:flex;gap:8px;margin-top:4px">
             <button class="spd-btn" id="d-spd-1" onclick="setSpeed(1)">
@@ -309,7 +336,7 @@
         </div>
 
         <!-- Lüfter -->
-        <div class="card">
+        <div class="card" id="card-fan" data-card="fan" gs-w="6" gs-h="3">
           <div class="card-title"><span>🌀</span> <span id="d-card-lightfan">Lüfter</span></div>
           <div class="slider-row">
             <input type="range" class="slider" min="0" max="100" value="0" id="d-fan" oninput="document.getElementById('d-fan-val').textContent=this.value" onchange="setFan()">
@@ -324,18 +351,19 @@
           </div>
         </div>
 
-        <div id="d-ace-dry-wrap" style="display:none">
-          <div id="d-ace-dry-grid" style="display:contents"></div>
-        </div>
-
         <!-- AMS -->
-        <div class="card" style="grid-column:1/-1" id="d-ams-card">
+        <div class="card" id="d-ams-card" data-card="ams" gs-w="12" gs-h="4">
           <div class="card-title"><span>◫</span> <span id="d-card-ams">Filament</span></div>
           <div class="ams-slots" id="ams-slots">
             <div style="grid-column:1/-1;text-align:center;color:var(--txt2);padding:20px" id="ams-no-data">Keine AMS-Daten empfangen</div>
           </div>
         </div>
       </div>
+      <!-- ACE-Trocknung: außerhalb des GridStack-Grids, per Drucker-State eingeblendet -->
+      <div id="d-ace-dry-wrap" class="grid" style="display:none;margin-top:16px">
+        <div id="d-ace-dry-grid" style="display:contents"></div>
+      </div>
+      <div id="dash-hidden-bar"></div>
     </div>
 
     <!-- ═══ CONSOLE ═══ -->
@@ -360,36 +388,81 @@
           <span id="store-panel-title">🗂 Datei-Browser</span>
           <button id="store-refresh-btn" onclick="loadStore()" style="font-size:12px;padding:4px 12px;background:var(--raised);border:1px solid var(--border);border-radius:6px;color:var(--txt2);cursor:pointer">↻ Aktualisieren</button>
         </div>
-        <div style="display:flex;gap:8px;margin-bottom:12px;flex-wrap:wrap">
-          <input id="store-search" type="text" placeholder="🔍 Suche…" oninput="renderStore()"
-            style="flex:1;min-width:140px;padding:6px 10px;background:var(--raised);border:1px solid var(--border);border-radius:6px;color:var(--txt);font-size:13px">
-          <select id="store-filter" onchange="renderStore()"
-            style="padding:6px 8px;background:var(--raised);border:1px solid var(--border);border-radius:6px;color:var(--txt);font-size:13px">
-            <option value="all" id="sf-all">Alle</option>
-            <option value="completed" id="sf-ok">✓ Erfolgreich</option>
-            <option value="failed" id="sf-err">✗ Fehler</option>
-            <option value="never" id="sf-new">Neu</option>
-          </select>
-          <select id="store-sort" onchange="renderStore()"
-            style="padding:6px 8px;background:var(--raised);border:1px solid var(--border);border-radius:6px;color:var(--txt);font-size:13px">
-            <option value="date_desc" id="ss-date">↓ Datum</option>
-            <option value="name_asc" id="ss-name">A–Z Name</option>
-            <option value="duration_asc" id="ss-dur">⏱ Druckzeit</option>
-          </select>
+        <div class="browser-subtabs" style="display:flex;gap:4px;margin-bottom:14px;border-bottom:1px solid var(--border)">
+          <button class="browser-tab active" id="btab-uploaded" onclick="showBrowserTab('uploaded')"
+            style="padding:8px 14px;background:none;border:none;border-bottom:2px solid transparent;color:var(--txt2);cursor:pointer;font-size:13px">
+            <span id="btab-lbl-uploaded">Hochgeladen</span></button>
+          <button class="browser-tab" id="btab-printer" onclick="showBrowserTab('printer')"
+            style="padding:8px 14px;background:none;border:none;border-bottom:2px solid transparent;color:var(--txt2);cursor:pointer;font-size:13px">
+            <span id="btab-lbl-printer">Auf dem Drucker</span></button>
         </div>
-        <div id="store-upload-zone" onclick="document.getElementById('store-upload-input').click()"
-          ondragover="event.preventDefault();this.classList.add('drag-over')"
-          ondragleave="this.classList.remove('drag-over')"
-          ondrop="event.preventDefault();this.classList.remove('drag-over');uploadGcode(event.dataTransfer.files[0])">
-          <input type="file" id="store-upload-input" accept=".gcode,.bgcode"
-            style="display:none" onchange="uploadGcode(this.files[0]);this.value=''">
-          <span id="store-upload-icon">⬆</span>
-          <span id="store-upload-label"><span id="store-upload-label-prefix">GCode hierher ziehen oder </span><u id="store-upload-label-browse">durchsuchen</u></span>
-          <span id="store-upload-status" style="display:none"></span>
+
+        <div id="browser-group-uploaded" class="browser-group active">
+          <div style="display:flex;gap:8px;margin-bottom:12px;flex-wrap:wrap">
+            <input id="store-search" type="text" placeholder="🔍 Suche…" oninput="renderStore()"
+              style="flex:1;min-width:140px;padding:6px 10px;background:var(--raised);border:1px solid var(--border);border-radius:6px;color:var(--txt);font-size:13px">
+            <select id="store-filter" onchange="renderStore()"
+              style="padding:6px 8px;background:var(--raised);border:1px solid var(--border);border-radius:6px;color:var(--txt);font-size:13px">
+              <option value="all" id="sf-all">Alle</option>
+              <option value="completed" id="sf-ok">✓ Erfolgreich</option>
+              <option value="failed" id="sf-err">✗ Fehler</option>
+              <option value="never" id="sf-new">Neu</option>
+            </select>
+            <select id="store-sort" onchange="renderStore()"
+              style="padding:6px 8px;background:var(--raised);border:1px solid var(--border);border-radius:6px;color:var(--txt);font-size:13px">
+              <option value="date_desc" id="ss-date">↓ Datum</option>
+              <option value="name_asc" id="ss-name">A–Z Name</option>
+              <option value="duration_asc" id="ss-dur">⏱ Druckzeit</option>
+            </select>
+          </div>
+          <div id="store-upload-zone" onclick="document.getElementById('store-upload-input').click()"
+            ondragover="event.preventDefault();this.classList.add('drag-over')"
+            ondragleave="this.classList.remove('drag-over')"
+            ondrop="event.preventDefault();this.classList.remove('drag-over');uploadGcode(event.dataTransfer.files[0])">
+            <input type="file" id="store-upload-input" accept=".gcode,.bgcode"
+              style="display:none" onchange="uploadGcode(this.files[0]);this.value=''">
+            <span id="store-upload-icon">⬆</span>
+            <span id="store-upload-label"><span id="store-upload-label-prefix">GCode hierher ziehen oder </span><u id="store-upload-label-browse">durchsuchen</u></span>
+            <span id="store-upload-status" style="display:none"></span>
+          </div>
+          <div id="store-empty" style="display:none;color:var(--txt2);text-align:center;padding:40px 0;font-size:14px">
+          </div>
+          <div id="store-select-bar" style="display:none;align-items:center;gap:10px;margin-bottom:12px;flex-wrap:wrap">
+            <label style="display:flex;align-items:center;gap:6px;cursor:pointer;font-size:13px">
+              <input type="checkbox" id="store-select-all" onchange="storeToggleSelectAll(this.checked)">
+              <span id="store-lbl-select-all">Alle auswählen</span>
+            </label>
+            <span id="store-selected-count" style="color:var(--txt2);font-size:13px"></span>
+            <button id="store-delete-selected-btn" disabled onclick="storeDeleteSelected()"
+              style="font-size:12px;padding:4px 12px;background:var(--raised);border:1px solid var(--border);border-radius:6px;color:var(--err);cursor:pointer">
+              🗑 <span id="store-lbl-delete-selected">Auswahl löschen</span></button>
+            <button onclick="storeExitSelectMode()"
+              style="font-size:12px;padding:4px 12px;background:var(--raised);border:1px solid var(--border);border-radius:6px;color:var(--txt2);cursor:pointer">
+              <span id="store-lbl-exit-select">Abbrechen</span></button>
+          </div>
+          <div id="store-grid" style="display:grid;grid-template-columns:repeat(auto-fill,minmax(200px,1fr));gap:14px"></div>
         </div>
-        <div id="store-empty" style="display:none;color:var(--txt2);text-align:center;padding:40px 0;font-size:14px">
+
+        <div id="browser-group-printer" class="browser-group">
+          <div id="printer-store-empty" style="display:none;color:var(--txt2);text-align:center;padding:40px 0;font-size:14px">
+          </div>
+          <div id="printer-store-error" style="display:none;color:var(--err);text-align:center;padding:20px 0;font-size:13px">
+          </div>
+          <div id="printer-store-select-bar" style="display:none;align-items:center;gap:10px;margin-bottom:12px;flex-wrap:wrap">
+            <label style="display:flex;align-items:center;gap:6px;cursor:pointer;font-size:13px">
+              <input type="checkbox" id="printer-store-select-all" onchange="printerFileToggleSelectAll(this.checked)">
+              <span id="printer-store-lbl-select-all">Alle auswählen</span>
+            </label>
+            <span id="printer-store-selected-count" style="color:var(--txt2);font-size:13px"></span>
+            <button id="printer-store-delete-selected-btn" disabled onclick="printerFileDeleteSelected()"
+              style="font-size:12px;padding:4px 12px;background:var(--raised);border:1px solid var(--border);border-radius:6px;color:var(--err);cursor:pointer">
+              🗑 <span id="printer-store-lbl-delete-selected">Auswahl löschen</span></button>
+            <button onclick="printerFileExitSelectMode()"
+              style="font-size:12px;padding:4px 12px;background:var(--raised);border:1px solid var(--border);border-radius:6px;color:var(--txt2);cursor:pointer">
+              <span id="printer-store-lbl-exit-select">Abbrechen</span></button>
+          </div>
+          <div id="printer-store-grid" style="display:grid;grid-template-columns:repeat(auto-fill,minmax(200px,1fr));gap:14px"></div>
         </div>
-        <div id="store-grid" style="display:grid;grid-template-columns:repeat(auto-fill,minmax(200px,1fr));gap:14px"></div>
       </div>
     </div>
 
@@ -475,6 +548,22 @@
                 <input type="text" id="s-mode-id" placeholder="20030">
               </div>
             </div>
+            <div class="card">
+              <div class="card-title"><span>🔌</span> <span id="modal-sec-power">Power Switch</span></div>
+              <div class="modal-field">
+                <label id="lbl-power-on-url">Power-On URL</label>
+                <input type="text" id="s-power-on-url" placeholder="http://192.168.x.x/cm?cmnd=Power%20on">
+              </div>
+              <div class="modal-field">
+                <label id="lbl-power-off-url">Power-Off URL</label>
+                <input type="text" id="s-power-off-url" placeholder="http://192.168.x.x/cm?cmnd=Power%20off">
+              </div>
+              <div class="modal-field">
+                <label id="lbl-power-status-url">Status URL</label>
+                <input type="text" id="s-power-status-url" placeholder="http://192.168.x.x/cm?cmnd=Power">
+                <small id="lbl-power-hint" style="color:var(--txt2)"></small>
+              </div>
+            </div>
           </div>
 
           <!-- Drucker -->
@@ -495,6 +584,10 @@
                 <input type="checkbox" id="s-auto-leveling" style="width:auto;margin:0">
                 <label id="lbl-auto-leveling" style="margin:0;cursor:pointer" for="s-auto-leveling">Auto-Leveling vor Druck</label>
               </div>
+              <div class="modal-field" style="flex-direction:row;align-items:center;gap:10px">
+                <input type="checkbox" id="s-vibration-compensation" style="width:auto;margin:0">
+                <label id="lbl-vibration-compensation" style="margin:0;cursor:pointer" for="s-vibration-compensation">Resonance compensation before print</label>
+              </div>
               <div class="modal-field">
                 <label id="lbl-file-ready-mode">Nach Upload: Druckstart-Verhalten</label>
                 <select id="s-file-ready-mode">
@@ -510,6 +603,11 @@
                 <input type="checkbox" id="s-web-upload-warning" style="width:auto;margin:0">
                 <label id="lbl-web-upload-warning" style="margin:0;cursor:pointer" for="s-web-upload-warning">Warnung bei Web-Upload-Druck anzeigen</label>
               </div>
+              <div class="modal-field" style="flex-direction:row;align-items:center;gap:10px">
+                <input type="checkbox" id="s-delete-printer-file-after-print" style="width:auto;margin:0">
+                <label id="lbl-delete-printer-file-after-print" style="margin:0;cursor:pointer" for="s-delete-printer-file-after-print">Delete file from printer after successful print</label>
+              </div>
+              <small id="lbl-delete-printer-file-after-print-hint" style="color:var(--txt2)"></small>
             </div>
           </div>
 
@@ -536,6 +634,10 @@
                 <input type="number" id="s-poll-interval" min="1" max="60" step="1" placeholder="3" oninput="onPollIntervalInput()">
                 <small style="color:var(--txt2)" id="lbl-poll-hint">Wie oft die Bridge den Drucker-Status abfragt</small>
               </div>
+              <div class="modal-field" style="flex-direction:row;align-items:center;gap:10px">
+                <input type="checkbox" id="s-verbose-http-log" style="width:auto;margin:0">
+                <label id="lbl-verbose-http-log" style="margin:0;cursor:pointer" for="s-verbose-http-log">Log every HTTP request (verbose)</label>
+              </div>
             </div>
           </div>
 
@@ -570,6 +672,12 @@
               <div id="visible-vendors-list" style="max-height:260px;overflow-y:auto;border:1px solid var(--border);border-radius:6px;padding:8px"></div>
               <button class="btn btn-sm" style="background:var(--accent);color:#fff;margin-top:8px" onclick="saveVisibleVendors()"><span id="lbl-visible-vendors-save">Auswahl speichern</span></button>
             </div>
+            <div class="card" id="spoolman-slot-card" style="display:none">
+              <div class="card-title"><span>🧵</span> <span id="lbl-spoolman-slot-assign">Spoolman — Slot-Zuordnung</span></div>
+              <div style="font-size:11px;color:var(--txt2);margin-bottom:10px" id="lbl-spoolman-slot-hint">Spoolman-Spool pro AMS-Slot zuweisen. Der Verbrauch wird beim Druck automatisch gemeldet.</div>
+              <div id="spoolman-slot-rows" style="display:flex;flex-direction:column;gap:8px"></div>
+              <button class="btn btn-sm" style="background:var(--accent);color:#fff;margin-top:10px" onclick="saveSpoolmanSlots()"><span id="lbl-spoolman-slot-save">Zuordnung speichern</span></button>
+            </div>
           </div>
 
           <!-- Integrationen -->
@@ -582,7 +690,7 @@
                 <input type="text" id="s-spoolman-url" placeholder="http://spoolman:7912" style="width:200px">
               </div>
               <div class="set-row">
-                <label id="lbl-spoolman-sync-rate">Sync-Rate (s, 0=aus)</label>
+                <label id="lbl-spoolman-sync-rate">Sync-Rate (s, 0=Druckende)</label>
                 <input type="number" id="s-spoolman-sync-rate" min="0" max="3600" value="30" style="width:80px">
               </div>
               <div id="spoolman-status-row" style="margin-top:6px;font-size:12px;color:var(--txt2)">
@@ -655,6 +763,7 @@
       <button onclick="closeFilamentDialog()" style="background:none;border:none;font-size:18px;cursor:pointer;color:var(--txt2)">✕</button>
     </div>
     <p id="fd-slots-hint" style="font-size:12px;color:var(--txt2);margin-bottom:10px">GCode-Kanal → AMS-Slot zuweisen:</p>
+    <div id="fd-mismatch-warn" style="display:none;margin-bottom:10px;padding:8px 10px;background:rgba(255,160,0,.12);border:1px solid rgba(255,160,0,.4);border-radius:8px;font-size:11px;color:#ffa000"></div>
     <div id="fd-slots" style="display:flex;flex-direction:column;gap:8px;margin-bottom:16px"></div>
     <div id="fd-objects-section" style="display:none;margin-bottom:16px">
       <button type="button" id="fd-objects-toggle" onclick="toggleFdObjects()"

web/themes/default/lib/gridstack.min.css

@@ -0,0 +1 @@
+.grid-stack{position:relative}.grid-stack-rtl{direction:ltr}.grid-stack-rtl>.grid-stack-item{direction:rtl}.grid-stack-placeholder>.placeholder-content{background-color:rgba(0,0,0,.1);margin:0;position:absolute;width:auto;z-index:0!important}.grid-stack>.grid-stack-item{position:absolute;padding:0}.grid-stack>.grid-stack-item>.grid-stack-item-content{margin:0;position:absolute;width:auto;overflow-x:hidden;overflow-y:auto}.grid-stack>.grid-stack-item.size-to-content:not(.size-to-content-max)>.grid-stack-item-content{overflow-y:hidden}.grid-stack-item>.ui-resizable-handle{position:absolute;font-size:.1px;display:block;-ms-touch-action:none;touch-action:none}.grid-stack-item.ui-resizable-autohide>.ui-resizable-handle,.grid-stack-item.ui-resizable-disabled>.ui-resizable-handle{display:none}.grid-stack-item>.ui-resizable-ne,.grid-stack-item>.ui-resizable-nw,.grid-stack-item>.ui-resizable-se,.grid-stack-item>.ui-resizable-sw{background-image:url('data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" fill="none" stroke="%23666" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" viewBox="0 0 20 20"><path d="m10 3 2 2H8l2-2v14l-2-2h4l-2 2"/></svg>');background-repeat:no-repeat;background-position:center}.grid-stack-item>.ui-resizable-ne{transform:translate(0,10px) rotate(45deg)}.grid-stack-item>.ui-resizable-sw{transform:rotate(45deg)}.grid-stack-item>.ui-resizable-nw{transform:translate(0,10px) rotate(-45deg)}.grid-stack-item>.ui-resizable-se{transform:rotate(-45deg)}.grid-stack-item>.ui-resizable-nw{cursor:nw-resize;width:20px;height:20px;top:0}.grid-stack-item>.ui-resizable-n{cursor:n-resize;height:10px;top:0;left:25px;right:25px}.grid-stack-item>.ui-resizable-ne{cursor:ne-resize;width:20px;height:20px;top:0}.grid-stack-item>.ui-resizable-e{cursor:e-resize;width:10px;top:15px;bottom:15px}.grid-stack-item>.ui-resizable-se{cursor:se-resize;width:20px;height:20px}.grid-stack-item>.ui-resizable-s{cursor:s-resize;height:10px;left:25px;bottom:0;right:25px}.grid-stack-item>.ui-resizable-sw{cursor:sw-resize;width:20px;height:20px}.grid-stack-item>.ui-resizable-w{cursor:w-resize;width:10px;top:15px;bottom:15px}.grid-stack-item.ui-draggable-dragging>.ui-resizable-handle{display:none!important}.grid-stack-item.ui-draggable-dragging{will-change:left,top;cursor:move}.grid-stack-item.ui-resizable-resizing{will-change:width,height}.ui-draggable-dragging,.ui-resizable-resizing{z-index:10000}.ui-draggable-dragging>.grid-stack-item-content,.ui-resizable-resizing>.grid-stack-item-content{box-shadow:1px 4px 6px rgba(0,0,0,.2);opacity:.8}.grid-stack-animate,.grid-stack-animate .grid-stack-item{transition:left .3s,top .3s,height .3s,width .3s}.grid-stack-animate .grid-stack-item.grid-stack-placeholder,.grid-stack-animate .grid-stack-item.ui-draggable-dragging,.grid-stack-animate .grid-stack-item.ui-resizable-resizing{transition:left 0s,top 0s,height 0s,width 0s}.grid-stack>.grid-stack-item[gs-y="0"]{top:0}.grid-stack>.grid-stack-item[gs-x="0"]{left:0}.gs-12>.grid-stack-item{width:8.333%}.gs-12>.grid-stack-item[gs-x="1"]{left:8.333%}.gs-12>.grid-stack-item[gs-w="2"]{width:16.667%}.gs-12>.grid-stack-item[gs-x="2"]{left:16.667%}.gs-12>.grid-stack-item[gs-w="3"]{width:25%}.gs-12>.grid-stack-item[gs-x="3"]{left:25%}.gs-12>.grid-stack-item[gs-w="4"]{width:33.333%}.gs-12>.grid-stack-item[gs-x="4"]{left:33.333%}.gs-12>.grid-stack-item[gs-w="5"]{width:41.667%}.gs-12>.grid-stack-item[gs-x="5"]{left:41.667%}.gs-12>.grid-stack-item[gs-w="6"]{width:50%}.gs-12>.grid-stack-item[gs-x="6"]{left:50%}.gs-12>.grid-stack-item[gs-w="7"]{width:58.333%}.gs-12>.grid-stack-item[gs-x="7"]{left:58.333%}.gs-12>.grid-stack-item[gs-w="8"]{width:66.667%}.gs-12>.grid-stack-item[gs-x="8"]{left:66.667%}.gs-12>.grid-stack-item[gs-w="9"]{width:75%}.gs-12>.grid-stack-item[gs-x="9"]{left:75%}.gs-12>.grid-stack-item[gs-w="10"]{width:83.333%}.gs-12>.grid-stack-item[gs-x="10"]{left:83.333%}.gs-12>.grid-stack-item[gs-w="11"]{width:91.667%}.gs-12>.grid-stack-item[gs-x="11"]{left:91.667%}.gs-12>.grid-stack-item[gs-w="12"]{width:100%}.gs-1>.grid-stack-item{width:100%}

web/themes/default/style.css

@@ -15,10 +15,46 @@
 body{background:var(--bg);color:var(--txt);font-family:var(--font);font-size:14px;min-height:100vh;display:flex;flex-direction:column}
 a{color:var(--accent);text-decoration:none}
 /* select/option-Farben explizit setzen — OrcaSlicers Device-Tab-Webview erbt
-   sie sonst nicht und rendert weiße Schrift auf weißem Grund (Issue #29). */
-select{background:var(--raised)!important;color:var(--txt)!important}
+   sie sonst nicht und rendert weiße Schrift auf weißem Grund (Issue #29).
+   Einheitliches Styling für alle Dropdowns im gesamten UI. */
+select{
+  background:var(--raised)!important;
+  color:var(--txt)!important;
+  border:1px solid var(--border)!important;
+  border-radius:8px!important;
+  padding:6px 10px!important;
+  font-size:13px!important;
+  appearance:none!important;
+  -webkit-appearance:none!important;
+  background-image:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='8' viewBox='0 0 12 8'%3E%3Cpath fill='%23888' d='M6 8L0 0h12z'/%3E%3C/svg%3E")!important;
+  background-repeat:no-repeat!important;
+  background-position:right 10px center!important;
+  padding-right:28px!important;
+  cursor:pointer!important;
+  outline:none!important;
+  box-sizing:border-box!important;
+}
+select:focus{border-color:var(--accent)!important;box-shadow:0 0 0 2px rgba(0,200,255,0.18)!important}
 select option{background:var(--card)!important;color:var(--txt)!important}
 
+/* Einheitliches Styling für Text/Number-Inputs */
+input[type=text],input[type=number],input[type=url],input[type=password],input[type=email],input[type=search]{
+  background:var(--raised);
+  color:var(--txt);
+  border:1px solid var(--border);
+  border-radius:8px;
+  padding:6px 10px;
+  font-size:13px;
+  outline:none;
+  box-sizing:border-box;
+}
+input[type=text]:focus,input[type=number]:focus,input[type=url]:focus,
+input[type=password]:focus,input[type=email]:focus,input[type=search]:focus{
+  border-color:var(--accent);
+  box-shadow:0 0 0 2px rgba(0,200,255,0.18);
+}
+input::placeholder{color:var(--txt2);opacity:1}
+
 /* ── HEADER ── */
 header{background:var(--card);border-bottom:1px solid var(--border);
   display:flex;align-items:center;gap:12px;padding:0 20px;height:52px;
@@ -59,18 +95,63 @@ main{flex:1;overflow-y:auto;padding:20px}
 
 /* ── CARD ── */
 .card{background:var(--card);border:1px solid var(--border);border-radius:12px;
-  padding:18px;transition:box-shadow .15s,transform .15s}
+  padding:18px;transition:box-shadow .15s,transform .15s;container-type:inline-size}
 .card:hover{box-shadow:0 4px 20px rgba(0,0,0,.3);transform:translateY(-1px)}
 .card-title{font-size:11px;text-transform:uppercase;letter-spacing:.1em;color:var(--txt2);
   margin-bottom:14px;display:flex;align-items:center;gap:8px}
 .card-title span{font-size:14px}
 
+/* ── DASHBOARD FREE GRID (GridStack) ── */
+/* .grid-stack-item-content is already position:absolute + fills the cell
+   (GridStack's own CSS). The card inside just needs to fill that box — it
+   must NOT be position:absolute itself, or it can sit above/intercept
+   GridStack's resize-handle hit area and drag listeners. */
+/* Doc pattern: the card fills its cell; content scrolls if the user resizes
+   the cell smaller than the content needs. */
+.grid-stack-item-content>.card{width:100%;height:100%;margin:0;overflow-y:auto;overflow-x:hidden;box-sizing:border-box}
+/* .card:hover{transform:translateY(-1px)} creates a new containing block right
+   as the user starts dragging, throwing off GridStack's position math. Kill
+   the hover transform for dashboard cards specifically. */
+.grid-stack-item-content>.card:hover{transform:none}
+/* Edit mode: dashed outline + grab cursor on each item */
+#dash-grid.editing .grid-stack-item-content>.card{cursor:grab;
+  outline:1px dashed var(--accent);outline-offset:-1px;user-select:none}
+/* GridStack placeholder styled to theme */
+.grid-stack>.grid-stack-placeholder>.placeholder-content{
+  background:rgba(120,150,255,.12);border:1px dashed var(--accent);border-radius:12px}
+/* Resize handles only visible in edit mode */
+#dash-grid:not(.editing) .ui-resizable-handle{display:none!important}
+/* Per-card controls (hide button) */
+.dash-card-controls{display:none;position:absolute;top:8px;right:8px;gap:4px;z-index:6}
+#dash-grid.editing .dash-card-controls{display:flex}
+.dash-card-ctrl-btn{width:24px;height:24px;border-radius:6px;border:1px solid var(--border);
+  background:var(--raised);color:var(--txt2);cursor:pointer;font-size:12px;
+  display:flex;align-items:center;justify-content:center;line-height:1}
+.dash-card-ctrl-btn:hover{color:var(--accent);border-color:var(--accent)}
+#dash-hidden-bar{display:none;flex-wrap:wrap;gap:8px;margin-top:12px;padding:10px;
+  border:1px dashed var(--border);border-radius:10px}
+#dash-hidden-bar.show{display:flex}
+.dash-hidden-chip{display:flex;align-items:center;gap:6px;padding:4px 10px;font-size:12px;
+  background:var(--raised);border:1px solid var(--border);border-radius:20px;color:var(--txt2)}
+.dash-hidden-chip button{background:none;border:none;color:var(--accent);cursor:pointer;font-size:12px;padding:0}
+
+@media(max-width:768px){
+  #dash-toolbar{display:none}
+}
+
 /* ── HERO ── */
 .hero{grid-column:1/-1;display:grid;grid-template-columns:1fr 320px;gap:16px}
 @media(max-width:900px){.hero{grid-template-columns:1fr}}
 .cam-wrap{background:#0a0a0e;border-radius:10px;overflow:hidden;
   min-height:180px;max-height:320px;display:flex;align-items:center;justify-content:center;position:relative}
-.cam-wrap img,.cam-wrap video{width:100%;max-height:320px;height:auto;display:block;object-fit:contain}
+.cam-wrap img,.cam-wrap video{width:100%;max-height:320px;height:auto;display:block;object-fit:contain;
+  -webkit-user-drag:none;user-select:none}
+/* Inside the dashboard grid the camera card can be resized taller than the
+   default 320px cap — flex column: title row keeps its height, cam view
+   flexes to fill whatever cell height the user chose. */
+.grid-stack-item-content>#card-camera{display:flex;flex-direction:column}
+.grid-stack-item-content .cam-wrap{flex:1;min-height:0;max-height:none}
+.grid-stack-item-content .cam-wrap img,.grid-stack-item-content .cam-wrap video{max-height:100%;height:100%}
 .cam-placeholder{color:var(--txt2);font-size:13px;text-align:center;padding:20px}
 @keyframes spin{to{transform:rotate(360deg)}}
 .cam-spinner{width:40px;height:40px;border:3px solid rgba(255,255,255,.15);
@@ -83,6 +164,11 @@ main{flex:1;overflow-y:auto;padding:20px}
 .cam-toggle:hover{background:rgba(0,0,0,.7)}
 
 /* ── PROGRESS ── */
+/* Same pattern as #card-camera above: without this, shrinking the tile's
+   height just clips the lower content (time-grid/filename/buttons) outside
+   the visible area instead of making it scrollable (Issue #97). */
+.grid-stack-item-content>#card-progress{display:flex;flex-direction:column;min-height:0}
+.grid-stack-item-content>#card-progress>*{flex-shrink:0}
 .hero-info{display:flex;flex-direction:column;gap:12px}
 .pct-big{font-size:52px;font-weight:700;line-height:1;color:var(--txt)}
 .pct-big small{font-size:20px;font-weight:400;color:var(--txt2)}
@@ -125,6 +211,12 @@ main{flex:1;overflow-y:auto;padding:20px}
 /* ── TEMPS ── */
 .temp-pair{display:grid;grid-template-columns:1fr 1fr;gap:12px}
 .temp-card-inner{display:grid;grid-template-columns:1fr 1fr;gap:12px}
+@container (max-width:340px){
+  .temp-card-inner{grid-template-columns:1fr}
+  .temp-val{font-size:24px}
+  .temp-edit{flex-wrap:wrap}
+  .temp-input{width:100%}
+}
 .temp-block{background:var(--raised);border-radius:10px;padding:14px;position:relative}
 .temp-label{font-size:11px;text-transform:uppercase;letter-spacing:.08em;color:var(--txt2);margin-bottom:6px}
 .temp-row{display:flex;align-items:baseline;gap:6px}
@@ -230,6 +322,12 @@ canvas.tchart{width:100%;height:60px;display:block;border-radius:6px;background:
   .set-cat .nav-text{display:inline}
 }
 
+/* ── BROWSER SUB-TABS (uploaded vs. on-printer files) ── */
+.browser-tab.active{color:var(--accent);border-bottom-color:var(--accent)!important}
+.browser-tab:hover{color:var(--txt)}
+.browser-group{display:none}
+.browser-group.active{display:block}
+
 /* ── FILE BROWSER UPLOAD ZONE ── */
 #store-upload-zone{
   display:flex;flex-direction:column;align-items:center;justify-content:center;
@@ -265,6 +363,8 @@ canvas.tchart{width:100%;height:60px;display:block;border-radius:6px;background:
 .modal-field input{background:var(--raised);border:1px solid var(--border);
   border-radius:7px;color:var(--txt);padding:7px 10px;font-size:13px;width:100%}
 .modal-field input:focus{outline:none;border-color:var(--accent)}
+.set-row{display:flex;flex-direction:column;gap:4px;margin-bottom:10px}
+.set-row label{font-size:12px;color:var(--txt2)}
 .poll-btns{display:flex;gap:8px}
 .poll-btn{flex:1;padding:7px;background:var(--raised);border:1px solid var(--border);
   border-radius:7px;color:var(--txt2);cursor:pointer;font-size:13px;transition:all .15s}

web/translations/de.json

@@ -42,6 +42,8 @@
   "apd_placeholder_name": "z.B. Kobra X Wohnzimmer",
   "apd_success": "Drucker hinzugefügt, Bridge startet neu…",
   "apd_title": "Drucker hinzufügen",
+  "browser_tab_printer": "Auf dem Drucker",
+  "browser_tab_uploaded": "Hochgeladen",
   "btn_cam_start": "▶ Kamera",
   "btn_cam_start2": "▶ Start",
   "btn_cam_stop": "◼ Kamera",
@@ -68,6 +70,18 @@
   "card_speed": "Druckgeschwindigkeit",
   "card_temps": "Temperaturen",
   "confirm_cancel": "Druck wirklich abbrechen?",
+  "dash_done": "Fertig",
+  "dash_edit": "Dashboard anpassen",
+  "dash_hidden_cards": "Ausgeblendete Karten",
+  "dash_hide": "Ausblenden",
+  "dash_preset_delete_confirm": "Preset \"{name}\" löschen?",
+  "dash_preset_name_prompt": "Preset-Name:",
+  "dash_preset_standard": "Standard",
+  "dash_preset_wide89": "Desktop breit",
+  "dash_reset": "Zurücksetzen",
+  "dash_save_preset": "Als Preset speichern",
+  "dash_show": "Einblenden",
+  "dash_toggle_width": "Breite umschalten",
   "fd_cancel": "Abbrechen",
   "fd_no_matching_material": "Kein passendes Material",
   "fd_no_slots_msg": "Keine belegten AMS-Slots.{br}Druck trotzdem starten?",
@@ -121,9 +135,10 @@
   "lbl_feed": "Einziehen",
   "lbl_layers": "Layer",
   "lbl_light": "💡 Licht",
+  "lbl_pause_reason": "Druck pausiert:",
   "lbl_remaining": "Restzeit:",
   "lbl_slicer_time": "Slicer-Schätzung:",
-  "lbl_spoolman_sync_rate": "Sync-Rate (s, 0=aus)",
+  "lbl_spoolman_sync_rate": "Sync-Rate (s, 0=Druckende)",
   "lbl_spoolman_url": "Server-URL",
   "lbl_unload": "Ausziehen",
   "lbl_zpos": "Z (mm)",
@@ -189,8 +204,7 @@
   "panel_extras_camera": "Kamera",
   "panel_extras_fan": "Lüfter",
   "panel_extras_light": "Licht",
-  "panel_motion_xy": "XY-Achsen",
-  "panel_motion_z": "Z-Achse",
+  "panel_motion_xy": "Achsensteuerung",
   "panel_print_btn_cancel": "✕ Abbrechen",
   "panel_print_btn_pause": "⏸ Pause",
   "panel_print_btn_resume": "▶ Fortsetzen",
@@ -200,12 +214,20 @@
   "panel_temps_chart": "Verlauf (letzte 60 Messungen)",
   "panel_temps_nozzle": "Düse",
   "print_auto_leveling": "Auto-Leveling für diesen Druck",
+  "printer_store_delete_confirm": "Datei vom Drucker löschen?",
+  "printer_store_delete_selected_confirm": "{n} ausgewählte Dateien vom Drucker löschen?",
+  "printer_store_empty": "Keine Dateien auf dem Drucker.",
+  "printer_store_unreachable": "Drucker nicht erreichbar oder Abfrage fehlgeschlagen.",
   "printers_active": "● aktiv",
   "printers_current": "Aktueller Drucker",
   "printers_empty_hint": "Noch kein Drucker eingerichtet.",
   "printers_loading": "Lade…",
   "printers_none": "Keine Drucker konfiguriert.",
   "printers_remove": "Drucker entfernen",
+  "printers_power": "Drucker-Stromversorgung schalten",
+  "printers_power_on": "Strom: An",
+  "printers_power_off": "Strom: Aus",
+  "printers_power_off_confirm": "Drucker-Strom ausschalten? Stelle sicher, dass kein Druck läuft.",
   "printers_remove_confirm": "Drucker \"{name}\" entfernen? Die Bridge startet neu.",
   "printers_switch": "Wechseln →",
   "progress_action_clear": "Leeren",
@@ -239,6 +261,11 @@
   "settings_language": "Sprache",
   "settings_mode_id": "Mode-ID",
   "settings_mode_id_placeholder": "20030",
+  "settings_power": "Steckdose (Ein/Aus)",
+  "settings_power_on_url": "Einschalt-URL",
+  "settings_power_off_url": "Ausschalt-URL",
+  "settings_power_status_url": "Status-URL",
+  "settings_power_hint": "Optional: einfache HTTP-GET-URLs für eine Steckdose (z.B. Tasmota), die den Drucker per Netzstrom schaltet. Leer lassen blendet den Power-Button aus.",
   "settings_mqtt_port": "MQTT-Port",
   "settings_mqtt_username_placeholder": "userXXXXXXXX",
   "settings_orca_profiles_import": "Profile importieren",
@@ -257,13 +284,17 @@
   "settings_title": "Einstellungen",
   "settings_username": "MQTT-Benutzername",
   "settings_vendor_filter_placeholder": "Hersteller suchen…",
+  "settings_verbose_http_log": "Jede HTTP-Anfrage loggen (ausführlich)",
   "settings_version": "Version",
+  "settings_vibration_compensation": "Resonanzkompensation",
   "settings_visible_vendors": "Sichtbare Hersteller (Profil-Dropdown)",
   "settings_visible_vendors_hint": "Nur diese Hersteller erscheinen im Slot-Profil-Dropdown. Nichts ausgewählt = alle anzeigen. „Generic\" und eigene Profile sind immer sichtbar.",
   "settings_visible_vendors_label": "Sichtbare Hersteller (Profil-Dropdown)",
   "settings_visible_vendors_save": "Auswahl speichern",
   "settings_visible_vendors_save_label": "Auswahl speichern",
   "settings_web_upload_warning": "Warnung bei Web-Upload-Druck anzeigen",
+  "settings_delete_printer_file_after_print": "Datei nach erfolgreichem Druck vom Drucker löschen",
+  "settings_delete_printer_file_after_print_hint": "Gilt nur für Drucke, die über diese Bridge gestartet wurden (selbst hochgeladene Dateien) - direkt am Drucker oder über Anycubic Slicer gestartete Drucke werden nie gelöscht, da davon sonst keine Kopie mehr existiert.",
   "sf_all": "Alle",
   "sf_err": "✗ Fehler",
   "sf_new": "Neu",
@@ -279,6 +310,7 @@
   "skip_sending": "Sende …",
   "skip_success": "Objekte werden übersprungen.",
   "skip_title": "✂ Objekte überspringen",
+  "slot_copy_from": "Farbe von Slot kopieren…",
   "slot_edit_color": "Farbe",
   "slot_edit_custom": "z.B. PLA, PETG, ABS…",
   "slot_edit_load": "⬇ Einziehen",
@@ -297,15 +329,20 @@
   "ss_dur": "⏱ Druckzeit",
   "ss_name": "A–Z Name",
   "store_delete_confirm": "Datei löschen?",
+  "store_delete_selected": "Auswahl löschen",
+  "store_delete_selected_confirm": "{n} ausgewählte Dateien löschen?",
   "store_download": "⬇ Download",
   "store_empty": "Noch keine Dateien hochgeladen.",
   "store_estimate": "Schätzung",
+  "store_exit_select": "Abbrechen",
   "store_never": "noch nicht gedruckt",
   "store_no_results": "Keine Dateien gefunden.",
   "store_print": "▶ Drucken",
   "store_print_confirm": "Datei drucken?",
   "store_refresh": "↻ Aktualisieren",
   "store_search_placeholder": "🔍 Suche…",
+  "store_select_all": "Alle auswählen",
+  "store_selected_count": "{n} ausgewählt",
   "store_upload_busy": "⏳ Hochladen…",
   "store_upload_error": "✗ {error}",
   "store_upload_label_browse": "durchsuchen",

web/translations/en.json

@@ -42,6 +42,8 @@
   "apd_placeholder_name": "e.g. Kobra X Living Room",
   "apd_success": "Printer added, bridge restarting…",
   "apd_title": "Add printer",
+  "browser_tab_printer": "On Printer",
+  "browser_tab_uploaded": "Uploaded",
   "btn_cam_start": "▶ Camera",
   "btn_cam_start2": "▶ Start",
   "btn_cam_stop": "◼ Camera",
@@ -68,6 +70,18 @@
   "card_speed": "Print Speed",
   "card_temps": "Temperatures",
   "confirm_cancel": "Really cancel the print?",
+  "dash_done": "Done",
+  "dash_edit": "Customize dashboard",
+  "dash_hidden_cards": "Hidden cards",
+  "dash_hide": "Hide",
+  "dash_preset_delete_confirm": "Delete preset \"{name}\"?",
+  "dash_preset_name_prompt": "Preset name:",
+  "dash_preset_standard": "Standard",
+  "dash_preset_wide89": "Wide desktop",
+  "dash_reset": "Reset",
+  "dash_save_preset": "Save as preset",
+  "dash_show": "Show",
+  "dash_toggle_width": "Toggle width",
   "fd_cancel": "Cancel",
   "fd_no_matching_material": "No matching material",
   "fd_no_slots_msg": "No loaded AMS slots.{br}Start print anyway?",
@@ -121,9 +135,10 @@
   "lbl_feed": "Load",
   "lbl_layers": "Layer",
   "lbl_light": "💡 Light",
+  "lbl_pause_reason": "Print paused:",
   "lbl_remaining": "Remaining:",
   "lbl_slicer_time": "Slicer estimate:",
-  "lbl_spoolman_sync_rate": "Sync rate (s, 0=off)",
+  "lbl_spoolman_sync_rate": "Sync rate (s, 0=end of print)",
   "lbl_spoolman_url": "Server URL",
   "lbl_unload": "Unload",
   "lbl_zpos": "Z (mm)",
@@ -189,8 +204,7 @@
   "panel_extras_camera": "Camera",
   "panel_extras_fan": "Fan",
   "panel_extras_light": "Light",
-  "panel_motion_xy": "XY Axes",
-  "panel_motion_z": "Z Axis",
+  "panel_motion_xy": "Axes Control",
   "panel_print_btn_cancel": "✕ Cancel",
   "panel_print_btn_pause": "⏸ Pause",
   "panel_print_btn_resume": "▶ Resume",
@@ -200,12 +214,20 @@
   "panel_temps_chart": "History (last 60 readings)",
   "panel_temps_nozzle": "Nozzle",
   "print_auto_leveling": "Auto-Leveling",
+  "printer_store_delete_confirm": "Delete file from the printer?",
+  "printer_store_delete_selected_confirm": "Delete {n} selected files from the printer?",
+  "printer_store_empty": "No files on the printer.",
+  "printer_store_unreachable": "Printer unreachable or query failed.",
   "printers_active": "● active",
   "printers_current": "Current printer",
   "printers_empty_hint": "No printer set up yet.",
   "printers_loading": "Loading…",
   "printers_none": "No printers configured.",
   "printers_remove": "Remove printer",
+  "printers_power": "Toggle printer power",
+  "printers_power_on": "Power: On",
+  "printers_power_off": "Power: Off",
+  "printers_power_off_confirm": "Turn printer power off? Make sure no print is running.",
   "printers_remove_confirm": "Remove printer \"{name}\"? The bridge will restart.",
   "printers_switch": "Switch →",
   "progress_action_clear": "Clear",
@@ -239,6 +261,11 @@
   "settings_language": "Language",
   "settings_mode_id": "Mode ID",
   "settings_mode_id_placeholder": "20030",
+  "settings_power": "Power Switch",
+  "settings_power_on_url": "Power-On URL",
+  "settings_power_off_url": "Power-Off URL",
+  "settings_power_status_url": "Status URL",
+  "settings_power_hint": "Optional: plain HTTP GET URLs for a smart plug (e.g. Tasmota) controlling the printer's mains power. Leave empty to hide the power button.",
   "settings_mqtt_port": "MQTT Port",
   "settings_mqtt_username_placeholder": "userXXXXXXXX",
   "settings_orca_profiles_import": "Import profiles",
@@ -257,13 +284,17 @@
   "settings_title": "Settings",
   "settings_username": "MQTT Username",
   "settings_vendor_filter_placeholder": "Search vendors…",
+  "settings_verbose_http_log": "Log every HTTP request (verbose)",
   "settings_version": "Version",
+  "settings_vibration_compensation": "Resonance Compensation",
   "settings_visible_vendors": "Visible vendors (profile dropdown)",
   "settings_visible_vendors_hint": "Only these vendors appear in the slot profile dropdown. Nothing selected = show all. \"Generic\" and your own profiles are always visible.",
   "settings_visible_vendors_label": "Visible vendors (profile dropdown)",
   "settings_visible_vendors_save": "Save selection",
   "settings_visible_vendors_save_label": "Save selection",
   "settings_web_upload_warning": "Show warning when printing web uploads",
+  "settings_delete_printer_file_after_print": "Delete file from printer after successful print",
+  "settings_delete_printer_file_after_print_hint": "Only applies to prints started through this bridge (files it uploaded itself) - prints started directly from the printer or Anycubic Slicer are never deleted, since no copy of those exists anywhere else.",
   "sf_all": "All",
   "sf_err": "✗ Failed",
   "sf_new": "New",
@@ -279,6 +310,7 @@
   "skip_sending": "Sending …",
   "skip_success": "Objects will be skipped.",
   "skip_title": "✂ Skip objects",
+  "slot_copy_from": "Copy color from slot…",
   "slot_edit_color": "Color",
   "slot_edit_custom": "e.g. PLA, PETG, ABS…",
   "slot_edit_load": "⬇ Load",
@@ -297,15 +329,20 @@
   "ss_dur": "⏱ Print time",
   "ss_name": "A–Z Name",
   "store_delete_confirm": "Delete file?",
+  "store_delete_selected": "Delete Selected",
+  "store_delete_selected_confirm": "Delete {n} selected files?",
   "store_download": "⬇ Download",
   "store_empty": "No files uploaded yet.",
   "store_estimate": "Estimate",
+  "store_exit_select": "Cancel",
   "store_never": "never printed",
   "store_no_results": "No files found.",
   "store_print": "▶ Print",
   "store_print_confirm": "Print file?",
   "store_refresh": "↻ Refresh",
   "store_search_placeholder": "🔍 Search…",
+  "store_select_all": "Select All",
+  "store_selected_count": "{n} selected",
   "store_upload_busy": "⏳ Uploading…",
   "store_upload_error": "✗ {error}",
   "store_upload_label_browse": "browse",

web/translations/es.json

@@ -42,6 +42,8 @@
   "apd_placeholder_name": "p. ej. Kobra X Sala",
   "apd_success": "Impresora añadida, reiniciando bridge…",
   "apd_title": "Agregar impresora",
+  "browser_tab_printer": "En la impresora",
+  "browser_tab_uploaded": "Subidos",
   "btn_cam_start": "▶ Cámara",
   "btn_cam_start2": "▶ Iniciar",
   "btn_cam_stop": "◼ Cámara",
@@ -68,6 +70,18 @@
   "card_speed": "Velocidad de impresión",
   "card_temps": "Temperaturas",
   "confirm_cancel": "¿Realmente cancelar la impresión?",
+  "dash_done": "Listo",
+  "dash_edit": "Personalizar panel",
+  "dash_hidden_cards": "Tarjetas ocultas",
+  "dash_hide": "Ocultar",
+  "dash_preset_delete_confirm": "¿Eliminar el preset \"{name}\"?",
+  "dash_preset_name_prompt": "Nombre del preset:",
+  "dash_preset_standard": "Estándar",
+  "dash_preset_wide89": "Escritorio ancho",
+  "dash_reset": "Restablecer",
+  "dash_save_preset": "Guardar como preset",
+  "dash_show": "Mostrar",
+  "dash_toggle_width": "Cambiar ancho",
   "fd_cancel": "Cancelar",
   "fd_no_matching_material": "No hay material compatible",
   "fd_no_slots_msg": "No hay slots AMS cargados.{br}¿Iniciar impresión de todos modos?",
@@ -121,9 +135,10 @@
   "lbl_feed": "Cargar",
   "lbl_layers": "Capa",
   "lbl_light": "💡 Luz",
+  "lbl_pause_reason": "Impresión pausada:",
   "lbl_remaining": "Restante:",
   "lbl_slicer_time": "Estimación del slicer:",
-  "lbl_spoolman_sync_rate": "Tasa de sincronización (s, 0=desact.)",
+  "lbl_spoolman_sync_rate": "Tasa de sincronización (s, 0=fin impresión)",
   "lbl_spoolman_url": "URL del servidor",
   "lbl_unload": "Descargar",
   "lbl_zpos": "Z (mm)",
@@ -189,8 +204,7 @@
   "panel_extras_camera": "Cámara",
   "panel_extras_fan": "Ventilador",
   "panel_extras_light": "Luz",
-  "panel_motion_xy": "Ejes XY",
-  "panel_motion_z": "Eje Z",
+  "panel_motion_xy": "Control de Ejes",
   "panel_print_btn_cancel": "✕ Cancelar",
   "panel_print_btn_pause": "⏸ Pausa",
   "panel_print_btn_resume": "▶ Reanudar",
@@ -200,12 +214,20 @@
   "panel_temps_chart": "Historial (últimas 60 lecturas)",
   "panel_temps_nozzle": "Boquilla",
   "print_auto_leveling": "Autonivelado para esta impresión",
+  "printer_store_delete_confirm": "¿Eliminar archivo de la impresora?",
+  "printer_store_delete_selected_confirm": "¿Eliminar {n} archivos seleccionados de la impresora?",
+  "printer_store_empty": "No hay archivos en la impresora.",
+  "printer_store_unreachable": "Impresora inaccesible o consulta fallida.",
   "printers_active": "● activa",
   "printers_current": "Impresora actual",
   "printers_empty_hint": "Aún no hay impresora configurada.",
   "printers_loading": "Cargando…",
   "printers_none": "No hay impresoras configuradas.",
   "printers_remove": "Eliminar impresora",
+  "printers_power": "Alternar alimentación de la impresora",
+  "printers_power_on": "Alimentación: Encendida",
+  "printers_power_off": "Alimentación: Apagada",
+  "printers_power_off_confirm": "¿Apagar la alimentación de la impresora? Asegúrate de que no haya ninguna impresión en curso.",
   "printers_remove_confirm": "¿Eliminar impresora \"{name}\"? El bridge se reiniciará.",
   "printers_switch": "Cambiar →",
   "progress_action_clear": "Vaciar",
@@ -239,6 +261,11 @@
   "settings_language": "Idioma",
   "settings_mode_id": "ID de modo",
   "settings_mode_id_placeholder": "20030",
+  "settings_power": "Enchufe inteligente",
+  "settings_power_on_url": "URL de encendido",
+  "settings_power_off_url": "URL de apagado",
+  "settings_power_status_url": "URL de estado",
+  "settings_power_hint": "Opcional: URLs HTTP GET para un enchufe inteligente (p.ej. Tasmota) que controla la alimentación de la impresora. Déjalo vacío para ocultar el botón de encendido.",
   "settings_mqtt_port": "MQTT Port",
   "settings_mqtt_username_placeholder": "userXXXXXXXX",
   "settings_orca_profiles_import": "Importar perfiles",
@@ -257,13 +284,17 @@
   "settings_title": "Configuración",
   "settings_username": "Usuario MQTT",
   "settings_vendor_filter_placeholder": "Buscar fabricantes…",
+  "settings_verbose_http_log": "Registrar cada solicitud HTTP (detallado)",
   "settings_version": "Versión",
+  "settings_vibration_compensation": "Compensación de resonancia",
   "settings_visible_vendors": "Fabricantes visibles (lista de perfiles)",
   "settings_visible_vendors_hint": "Solo estos fabricantes aparecen en la lista de perfiles de ranura. Nada seleccionado = mostrar todos. «Generic» y tus propios perfiles siempre son visibles.",
   "settings_visible_vendors_label": "Fabricantes visibles (lista de perfiles)",
   "settings_visible_vendors_save": "Guardar selección",
   "settings_visible_vendors_save_label": "Guardar selección",
   "settings_web_upload_warning": "Mostrar advertencia al imprimir subidas web",
+  "settings_delete_printer_file_after_print": "Eliminar archivo de la impresora tras una impresión exitosa",
+  "settings_delete_printer_file_after_print_hint": "Solo aplica a impresiones iniciadas a través de este bridge (archivos que él mismo subió) - las impresiones iniciadas directamente desde la impresora o Anycubic Slicer nunca se eliminan, ya que no existe ninguna copia en otro lugar.",
   "sf_all": "Todos",
   "sf_err": "✗ Fallido",
   "sf_new": "Nuevo",
@@ -279,6 +310,7 @@
   "skip_sending": "Enviando …",
   "skip_success": "Se omitirán los objetos.",
   "skip_title": "✂ Omitir objetos",
+  "slot_copy_from": "Copiar color del slot…",
   "slot_edit_color": "Color",
   "slot_edit_custom": "p. ej. PLA, PETG, ABS…",
   "slot_edit_load": "⬇ Cargar",
@@ -297,15 +329,20 @@
   "ss_dur": "⏱ Tiempo de impresión",
   "ss_name": "A–Z Nombre",
   "store_delete_confirm": "¿Eliminar archivo?",
+  "store_delete_selected": "Eliminar seleccionados",
+  "store_delete_selected_confirm": "¿Eliminar {n} archivos seleccionados?",
   "store_download": "⬇ Descargar",
   "store_empty": "Aún no hay archivos subidos.",
   "store_estimate": "Estimación",
+  "store_exit_select": "Cancelar",
   "store_never": "nunca impreso",
   "store_no_results": "No se encontraron archivos.",
   "store_print": "▶ Imprimir",
   "store_print_confirm": "¿Imprimir archivo?",
   "store_refresh": "↻ Actualizar",
   "store_search_placeholder": "🔍 Buscar…",
+  "store_select_all": "Seleccionar todo",
+  "store_selected_count": "{n} seleccionados",
   "store_upload_busy": "⏳ Subiendo…",
   "store_upload_error": "✗ {error}",
   "store_upload_label_browse": "buscar",

web/translations/fr.json

@@ -42,6 +42,8 @@
   "apd_placeholder_name": "ex. Kobra X Salon",
   "apd_success": "Imprimante ajoutée, redémarrage du bridge…",
   "apd_title": "Ajouter une imprimante",
+  "browser_tab_printer": "Sur l'imprimante",
+  "browser_tab_uploaded": "Téléversés",
   "btn_cam_start": "▶ Caméra",
   "btn_cam_start2": "▶ Démarrer",
   "btn_cam_stop": "◼ Caméra",
@@ -121,9 +123,10 @@
   "lbl_feed": "Charger",
   "lbl_layers": "Couche",
   "lbl_light": "💡 Lumière",
+  "lbl_pause_reason": "Impression en pause :",
   "lbl_remaining": "Restant :",
   "lbl_slicer_time": "Estimation slicer :",
-  "lbl_spoolman_sync_rate": "Taux de sync. (s, 0=désact.)",
+  "lbl_spoolman_sync_rate": "Taux de sync. (s, 0=fin impression)",
   "lbl_spoolman_url": "URL du serveur",
   "lbl_unload": "Décharger",
   "lbl_zpos": "Z (mm)",
@@ -189,8 +192,7 @@
   "panel_extras_camera": "Caméra",
   "panel_extras_fan": "Ventilateur",
   "panel_extras_light": "Lumière",
-  "panel_motion_xy": "Axes XY",
-  "panel_motion_z": "Axe Z",
+  "panel_motion_xy": "Contrôle des Axes",
   "panel_print_btn_cancel": "✕ Annuler",
   "panel_print_btn_pause": "⏸ Pause",
   "panel_print_btn_resume": "▶ Reprendre",
@@ -200,12 +202,20 @@
   "panel_temps_chart": "Historique (60 dernières valeurs)",
   "panel_temps_nozzle": "Buse",
   "print_auto_leveling": "Mise à niveau auto pour cette impression",
+  "printer_store_delete_confirm": "Supprimer le fichier de l'imprimante ?",
+  "printer_store_delete_selected_confirm": "Supprimer {n} fichiers sélectionnés de l'imprimante ?",
+  "printer_store_empty": "Aucun fichier sur l'imprimante.",
+  "printer_store_unreachable": "Imprimante injoignable ou requête échouée.",
   "printers_active": "● actif",
   "printers_current": "Imprimante actuelle",
   "printers_empty_hint": "Aucune imprimante configurée.",
   "printers_loading": "Chargement…",
   "printers_none": "Aucune imprimante configurée.",
   "printers_remove": "Supprimer l'imprimante",
+  "printers_power": "Basculer l'alimentation de l'imprimante",
+  "printers_power_on": "Alimentation : Allumée",
+  "printers_power_off": "Alimentation : Éteinte",
+  "printers_power_off_confirm": "Éteindre l'alimentation de l'imprimante ? Assurez-vous qu'aucune impression n'est en cours.",
   "printers_remove_confirm": "Supprimer l'imprimante \"{name}\" ? Le bridge va redémarrer.",
   "printers_switch": "Changer →",
   "progress_action_clear": "Vider",
@@ -239,6 +249,11 @@
   "settings_language": "Langue",
   "settings_mode_id": "ID du mode",
   "settings_mode_id_placeholder": "20030",
+  "settings_power": "Prise électrique",
+  "settings_power_on_url": "URL d'allumage",
+  "settings_power_off_url": "URL d'extinction",
+  "settings_power_status_url": "URL de statut",
+  "settings_power_hint": "Optionnel : URL HTTP GET pour une prise connectée (ex. Tasmota) contrôlant l'alimentation secteur de l'imprimante. Laisser vide masque le bouton d'alimentation.",
   "settings_mqtt_port": "Port MQTT",
   "settings_mqtt_username_placeholder": "userXXXXXXXX",
   "settings_orca_profiles_import": "Importer des profils",
@@ -264,6 +279,8 @@
   "settings_visible_vendors_save": "Enregistrer la sélection",
   "settings_visible_vendors_save_label": "Enregistrer la sélection",
   "settings_web_upload_warning": "Afficher un avertissement lors de l'impression de fichiers web",
+  "settings_delete_printer_file_after_print": "Supprimer le fichier de l'imprimante après une impression réussie",
+  "settings_delete_printer_file_after_print_hint": "S'applique uniquement aux impressions lancées via ce bridge (fichiers qu'il a lui-même téléversés) - les impressions lancées directement depuis l'imprimante ou Anycubic Slicer ne sont jamais supprimées, car aucune copie n'existe ailleurs.",
   "sf_all": "Tout",
   "sf_err": "✗ Échoués",
   "sf_new": "Nouveau",
@@ -279,6 +296,7 @@
   "skip_sending": "Envoi …",
   "skip_success": "Les objets seront ignorés.",
   "skip_title": "✂ Ignorer des objets",
+  "slot_copy_from": "Copier la couleur du slot…",
   "slot_edit_color": "Couleur",
   "slot_edit_custom": "ex. PLA, PETG, ABS…",
   "slot_edit_load": "⬇ Charger",
@@ -297,15 +315,20 @@
   "ss_dur": "⏱ Durée d'impression",
   "ss_name": "A–Z Nom",
   "store_delete_confirm": "Supprimer le fichier ?",
+  "store_delete_selected": "Supprimer la sélection",
+  "store_delete_selected_confirm": "Supprimer {n} fichiers sélectionnés ?",
   "store_download": "⬇ Télécharger",
   "store_empty": "Aucun fichier uploadé.",
   "store_estimate": "Estimation",
+  "store_exit_select": "Annuler",
   "store_never": "jamais imprimé",
   "store_no_results": "Aucun fichier trouvé.",
   "store_print": "▶ Imprimer",
   "store_print_confirm": "Imprimer le fichier ?",
   "store_refresh": "↻ Actualiser",
   "store_search_placeholder": "🔍 Rechercher…",
+  "store_select_all": "Tout sélectionner",
+  "store_selected_count": "{n} sélectionné(s)",
   "store_upload_busy": "⏳ Envoi en cours…",
   "store_upload_error": "✗ {error}",
   "store_upload_label_browse": "parcourir",

web/translations/it.json

@@ -42,6 +42,8 @@
   "apd_placeholder_name": "es. Kobra X Soggiorno",
   "apd_success": "Stampante aggiunta, riavvio del bridge in corso…",
   "apd_title": "Aggiungi stampante",
+  "browser_tab_printer": "Sulla stampante",
+  "browser_tab_uploaded": "Caricati",
   "btn_cam_start": "▶ Camera",
   "btn_cam_start2": "▶ Avvia",
   "btn_cam_stop": "◼ Camera",
@@ -121,9 +123,10 @@
   "lbl_feed": "Carica",
   "lbl_layers": "Layer",
   "lbl_light": "💡 Luce",
+  "lbl_pause_reason": "Stampa in pausa:",
   "lbl_remaining": "Rimanente:",
   "lbl_slicer_time": "Stima slicer:",
-  "lbl_spoolman_sync_rate": "Frequenza sync (s, 0=disatt.)",
+  "lbl_spoolman_sync_rate": "Frequenza sync (s, 0=fine stampa)",
   "lbl_spoolman_url": "URL server",
   "lbl_unload": "Rimuovi",
   "lbl_zpos": "Z (mm)",
@@ -189,8 +192,7 @@
   "panel_extras_camera": "Camera",
   "panel_extras_fan": "Ventola",
   "panel_extras_light": "Luce",
-  "panel_motion_xy": "Assi XY",
-  "panel_motion_z": "Asse Z",
+  "panel_motion_xy": "Controllo Assi",
   "panel_print_btn_cancel": "✕ Annulla",
   "panel_print_btn_pause": "⏸ Pausa",
   "panel_print_btn_resume": "▶ Riprendi",
@@ -200,12 +202,20 @@
   "panel_temps_chart": "Cronologia (ultime 60 letture)",
   "panel_temps_nozzle": "Ugello",
   "print_auto_leveling": "Livellamento automatico",
+  "printer_store_delete_confirm": "Eliminare il file dalla stampante?",
+  "printer_store_delete_selected_confirm": "Eliminare {n} file selezionati dalla stampante?",
+  "printer_store_empty": "Nessun file sulla stampante.",
+  "printer_store_unreachable": "Stampante non raggiungibile o richiesta fallita.",
   "printers_active": "● attiva",
   "printers_current": "Stampante corrente",
   "printers_empty_hint": "Nessuna stampante ancora configurata.",
   "printers_loading": "Caricamento in corso…",
   "printers_none": "Nessuna stampante configurata.",
   "printers_remove": "Rimuovi stampante",
+  "printers_power": "Attiva/disattiva alimentazione stampante",
+  "printers_power_on": "Alimentazione: Accesa",
+  "printers_power_off": "Alimentazione: Spenta",
+  "printers_power_off_confirm": "Spegnere l'alimentazione della stampante? Assicurati che non sia in corso alcuna stampa.",
   "printers_remove_confirm": "Rimuovere la stampante \"{name}\"? Il bridge si riavvierà.",
   "printers_switch": "Cambia →",
   "progress_action_clear": "Cancella",
@@ -239,6 +249,11 @@
   "settings_language": "Lingua",
   "settings_mode_id": "ID modalità",
   "settings_mode_id_placeholder": "20030",
+  "settings_power": "Presa elettrica",
+  "settings_power_on_url": "URL accensione",
+  "settings_power_off_url": "URL spegnimento",
+  "settings_power_status_url": "URL stato",
+  "settings_power_hint": "Opzionale: URL HTTP GET per una presa smart (es. Tasmota) che controlla l'alimentazione della stampante. Lasciare vuoto per nascondere il pulsante di accensione.",
   "settings_mqtt_port": "Porta MQTT",
   "settings_mqtt_username_placeholder": "userXXXXXXXX",
   "settings_orca_profiles_import": "Importa profili",
@@ -264,6 +279,8 @@
   "settings_visible_vendors_save": "Salva selezione",
   "settings_visible_vendors_save_label": "Salva selezione",
   "settings_web_upload_warning": "Mostra un avviso quando si stampano caricamenti web",
+  "settings_delete_printer_file_after_print": "Elimina il file dalla stampante dopo una stampa riuscita",
+  "settings_delete_printer_file_after_print_hint": "Si applica solo alle stampe avviate tramite questo bridge (file caricati da esso) - le stampe avviate direttamente dalla stampante o da Anycubic Slicer non vengono mai eliminate, poiché non ne esiste alcuna copia altrove.",
   "sf_all": "Tutti",
   "sf_err": "✗ Fallito",
   "sf_new": "Nuovo",
@@ -279,6 +296,7 @@
   "skip_sending": "Invio in corso …",
   "skip_success": "Gli oggetti verranno saltati.",
   "skip_title": "✂ Salta oggetti",
+  "slot_copy_from": "Copia colore dallo slot…",
   "slot_edit_color": "Colore",
   "slot_edit_custom": "es. PLA, PETG, ABS…",
   "slot_edit_load": "⬇ Carica",
@@ -297,15 +315,20 @@
   "ss_dur": "⏱ Tempo di stampa",
   "ss_name": "Nome A–Z",
   "store_delete_confirm": "Eliminare il file?",
+  "store_delete_selected": "Elimina selezionati",
+  "store_delete_selected_confirm": "Eliminare {n} file selezionati?",
   "store_download": "⬇ Scarica",
   "store_empty": "Nessun file caricato.",
   "store_estimate": "Stima",
+  "store_exit_select": "Annulla",
   "store_never": "mai stampato",
   "store_no_results": "Nessun file trovato.",
   "store_print": "▶ Stampa",
   "store_print_confirm": "Stampare il file?",
   "store_refresh": "↻ Aggiorna",
   "store_search_placeholder": "🔍 Cerca…",
+  "store_select_all": "Seleziona tutto",
+  "store_selected_count": "{n} selezionati",
   "store_upload_busy": "⏳ Caricamento in corso…",
   "store_upload_error": "✗ {error}",
   "store_upload_label_browse": "sfoglia",

web/translations/zh-cn.json

@@ -42,6 +42,8 @@
   "apd_placeholder_name": "例如 Kobra X 客厅",
   "apd_success": "打印机已添加，Bridge 正在重启…",
   "apd_title": "添加打印机",
+  "browser_tab_printer": "打印机上",
+  "browser_tab_uploaded": "已上传",
   "btn_cam_start": "▶ 相机",
   "btn_cam_start2": "▶ 启动",
   "btn_cam_stop": "◼ 相机",
@@ -68,6 +70,18 @@
   "card_speed": "打印速度",
   "card_temps": "温度",
   "confirm_cancel": "确定要取消打印吗?",
+  "dash_done": "完成",
+  "dash_edit": "自定义仪表盘",
+  "dash_hidden_cards": "隐藏的卡片",
+  "dash_hide": "隐藏",
+  "dash_preset_delete_confirm": "删除预设 \"{name}\"？",
+  "dash_preset_name_prompt": "预设名称：",
+  "dash_preset_standard": "标准",
+  "dash_preset_wide89": "宽屏桌面",
+  "dash_reset": "重置",
+  "dash_save_preset": "另存为预设",
+  "dash_show": "显示",
+  "dash_toggle_width": "切换宽度",
   "fd_cancel": "取消",
   "fd_no_matching_material": "无匹配材料",
   "fd_no_slots_msg": "没有已装载的 AMS 槽位。{br}仍要开始打印吗?",
@@ -121,9 +135,10 @@
   "lbl_feed": "进料",
   "lbl_layers": "层",
   "lbl_light": "💡 灯光",
+  "lbl_pause_reason": "打印已暂停：",
   "lbl_remaining": "剩余时间:",
   "lbl_slicer_time": "切片预估:",
-  "lbl_spoolman_sync_rate": "同步频率（秒，0=关闭）",
+  "lbl_spoolman_sync_rate": "同步频率（秒，0=打印结束）",
   "lbl_spoolman_url": "服务器地址",
   "lbl_unload": "退料",
   "lbl_zpos": "Z (mm)",
@@ -189,8 +204,7 @@
   "panel_extras_camera": "相机",
   "panel_extras_fan": "风扇",
   "panel_extras_light": "灯光",
-  "panel_motion_xy": "XY 轴",
-  "panel_motion_z": "Z 轴",
+  "panel_motion_xy": "轴控制",
   "panel_print_btn_cancel": "✕ 取消",
   "panel_print_btn_pause": "⏸ 暂停",
   "panel_print_btn_resume": "▶ 继续",
@@ -200,12 +214,20 @@
   "panel_temps_chart": "历史 (最近 60 次读数)",
   "panel_temps_nozzle": "喷嘴",
   "print_auto_leveling": "本次打印自动调平",
+  "printer_store_delete_confirm": "从打印机删除文件？",
+  "printer_store_delete_selected_confirm": "从打印机删除选中的 {n} 个文件？",
+  "printer_store_empty": "打印机上没有文件。",
+  "printer_store_unreachable": "无法连接打印机或查询失败。",
   "printers_active": "● 活动",
   "printers_current": "当前打印机",
   "printers_empty_hint": "尚未设置打印机。",
   "printers_loading": "加载中…",
   "printers_none": "未配置打印机。",
   "printers_remove": "移除打印机",
+  "printers_power": "切换打印机电源",
+  "printers_power_on": "电源：开",
+  "printers_power_off": "电源：关",
+  "printers_power_off_confirm": "关闭打印机电源？请确认当前没有正在进行的打印任务。",
   "printers_remove_confirm": "移除打印机 \"{name}\"? Bridge 将重启。",
   "printers_switch": "切换 →",
   "progress_action_clear": "清除",
@@ -239,6 +261,11 @@
   "settings_language": "语言",
   "settings_mode_id": "模式 ID",
   "settings_mode_id_placeholder": "20030",
+  "settings_power": "电源插座",
+  "settings_power_on_url": "开机 URL",
+  "settings_power_off_url": "关机 URL",
+  "settings_power_status_url": "状态 URL",
+  "settings_power_hint": "可选：智能插座（如 Tasmota）的 HTTP GET 控制 URL，用于控制打印机的电源。留空则隐藏电源按钮。",
   "settings_mqtt_port": "MQTT 端口",
   "settings_mqtt_username_placeholder": "userXXXXXXXX",
   "settings_orca_profiles_import": "导入配置文件",
@@ -257,13 +284,17 @@
   "settings_title": "设置",
   "settings_username": "MQTT 用户名",
   "settings_vendor_filter_placeholder": "搜索厂商…",
+  "settings_verbose_http_log": "记录每个 HTTP 请求（详细模式）",
   "settings_version": "版本",
+  "settings_vibration_compensation": "打印前共振补偿",
   "settings_visible_vendors": "可见厂商（配置下拉框）",
   "settings_visible_vendors_hint": "仅这些厂商会出现在槽位配置下拉框中。未选择 = 显示全部。“Generic”和您自己的配置始终可见。",
   "settings_visible_vendors_label": "可见厂商（配置下拉框）",
   "settings_visible_vendors_save": "保存选择",
   "settings_visible_vendors_save_label": "保存选择",
   "settings_web_upload_warning": "打印网页上传文件时显示警告",
+  "settings_delete_printer_file_after_print": "打印成功后从打印机删除文件",
+  "settings_delete_printer_file_after_print_hint": "仅适用于通过此网桥启动的打印（即由网桥自己上传的文件）——直接从打印机或 Anycubic Slicer 启动的打印任务永远不会被删除，因为它们没有其他备份。",
   "sf_all": "全部",
   "sf_err": "✗ 失败",
   "sf_new": "新",
@@ -279,6 +310,7 @@
   "skip_sending": "发送中 …",
   "skip_success": "对象将被跳过。",
   "skip_title": "✂ 跳过对象",
+  "slot_copy_from": "从插槽复制颜色…",
   "slot_edit_color": "颜色",
   "slot_edit_custom": "例如 PLA, PETG, ABS…",
   "slot_edit_load": "⬇ 进料",
@@ -297,15 +329,20 @@
   "ss_dur": "⏱ 打印时间",
   "ss_name": "A–Z 名称",
   "store_delete_confirm": "删除文件?",
+  "store_delete_selected": "删除所选",
+  "store_delete_selected_confirm": "删除已选择的 {n} 个文件?",
   "store_download": "⬇ 下载",
   "store_empty": "尚未上传文件。",
   "store_estimate": "估算",
+  "store_exit_select": "取消",
   "store_never": "从未打印",
   "store_no_results": "未找到文件。",
   "store_print": "▶ 打印",
   "store_print_confirm": "打印文件?",
   "store_refresh": "↻ 刷新",
   "store_search_placeholder": "🔍 搜索…",
+  "store_select_all": "全选",
+  "store_selected_count": "已选择 {n} 个",
   "store_upload_busy": "⏳ 上传中…",
   "store_upload_error": "✗ {error}",
   "store_upload_label_browse": "浏览",