# 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
- **Italian language support** (PR #66, @Alex_M). The bridge UI is now fully
  available in Italian.

### Fixed
- **Camera always started at print begin** (issue #50). `camera_on_print` was
  missing from the `/api/state` response — JavaScript read `undefined` and started
  the camera regardless of the setting. Now correctly exposed in state.
- **Auto-leveling setting ignored in Moonraker print path** (issue #57).
  `handle_print_start` read the value only from bridge args, not from the request
  body, so the dialog checkbox and the per-print override had no effect. Now
  behaves identically to the direct print path.
- **Filament mapping free-text fields replaced by dropdowns** (issue #57). A
  mistyped vendor/name broke profile matching silently; fields are now dropdowns
  (vendor → profile, vendor-filtered) so only valid combinations can be saved.
- **Dashboard showed generic material type instead of profile name** (issue #57).
  AMS slot cards now display the mapped profile name (e.g. "eSUN PLA-Basic")
  instead of just "PLA". Falls back to the generic type when no profile is mapped.
- **Ghost profile shown on empty slot** (issue #57). Stale mappings for empty
  slots were still rendered; empty slots now correctly show "–".
- **Skip-Objects panel missing in Orca upload flow** (issue #57). Panel now
  appears in all print flows; on fresh upload the bridge requests `fileDetails`
  from the printer and retries the object list for up to 6 s.
- **Banner and dialog appeared simultaneously** (issue #57). Settings save now
  resets the dialog cancel state so the slot mapper reliably opens after toggling
  Start Print Behavior.
- **"Clear" reloaded idle file on next poll** (issue #57). Clear now immediately
  resets local state (`file_ready`, `filename`, `thumbnail`) and clears all dialog
  locks — the preview and action buttons disappear instantly and do not return.
- **Material matching for "PLA Silk", "Matte PLA" etc.** (PR #64, @p2l).
  Modifier+base patterns in any word order are now normalised to the base type;
  dash-suffix variants (PLA-CF) remain correctly incompatible with their base.

## [0.9.25] – 2026-06-17

### Fixed
- **Random crashes / container restarts — segfault in `libcrypto.so.3` (issue #53).**
  The MQTT-over-TLS client shared a single SSL socket between the reader thread
  (`recv`) and the sender threads (`sendall`) without serializing them. CPython's
  `ssl` module does not allow concurrent read and write on the same socket — the
  overlap corrupted OpenSSL's internal state, causing a heap corruption and a
  segfault that manifested reliably on some hosts (timing-dependent). All socket
  access (recv / sendall / close / reconnect) is now serialized under a single
  lock; the reader probes readiness with `select()` outside the lock so senders
  are never starved. Reconnect and disconnect now swap the socket atomically.
  Thanks to @BasK for the detailed fault-handler trace that pinpointed this.
- **File browser accepted non-GCode uploads (issue #59).** Drag & drop bypassed
  the file picker's `accept` filter, so e.g. a JPG could be uploaded. Uploads are
  now validated both client- and server-side; only `.gcode`, `.gcode.3mf`, `.3mf`
  and `.bgcode` are accepted. Thanks @gangoke.

## [0.9.24] – 2026-06-16

### New
- **Skip Objects available in every print flow (issue #57).** The "Skip objects"
  panel in the Slot Mapper used to appear only when printing from the Browser tab.
  It now shows in all flows (upload / print bar included), collapsed by default
  behind a `✂ Skip objects (N)` header to keep the dialog compact, expanding on
  click with the object preview and checklist.
- **Slot Mapper shows the specific profile name (issue #57).** Each slot now
  displays its mapped filament profile (e.g. "PolyTerra PLA — Polymaker") in the
  dropdown options and as a hover tooltip on the slot marker, instead of just the
  generic type. Falls back to the generic type when no profile is mapped.

## [0.9.23] – 2026-06-16

### New
- **Auto-open print dialog after upload.** A new `print_start_dialog` setting
  (Settings → Printer → "Start Print Behavior") controls what happens after a
  file is uploaded while the printer is idle: `Print Dialog` opens the
  slot-assignment dialog automatically, `Print Bar` keeps the previous banner
  behaviour. Based on PR #56 by @gangoke.
- **Per-print auto-leveling toggle.** The print dialog now has its own
  auto-leveling checkbox that overrides the global default for a single print.

### Fixed
- **Object skip was silently ignored at print start (PR #56, @gangoke).** The
  skip command was sent *before* the printer entered the `printing` state, so it
  was dropped. The skip is now re-applied in a retry loop once the print is
  confirmed running, with a pending-lock so the UI doesn't reset the skip state
  prematurely.
- **Upload during an active print overwrote the running job's preview.**
  Uploading a new file while printing no longer replaces the thumbnail /
  file_ready of the job currently on the bed.

## [0.9.22] – 2026-06-16

### New
- **Restructured Settings panel.** The settings modal has been replaced by a
  persistent Master-Detail panel with five categories: Connection, Printer,
  Appearance, Filament, and System. Poll interval is now adjustable live.
- **Vendor visibility filter (issue #41).** A new checklist in the Filament
  settings lets you restrict the slot profile dropdown to specific manufacturers.
  "Generic" and your own imported profiles are always visible. The list updates
  automatically after a profile import.
- **Idle file actions in the progress card (issue #55).** After uploading a file
  while the printer is idle, three quick-action buttons appear directly in the
  progress card: ▶ Print, ⚙ Map Slots, and ✕ Clear — matching the file browser
  workflow without navigating away.

### Fixed
- **Mobileraker: app crashed with `Null is not a subtype of Object` in
  `ConfigExtruder.fromJson` (issue #48).** `configfile.config` was returned as
  an empty object `{}`. Mobileraker parses both `configfile.settings` and
  `configfile.config` through the same strict Dart parser — both are now
  populated with the same extruder/bed/stepper stub.
- **Mobileraker: app hung indefinitely on refresh (issue #48).** The WebSocket
  `server.files.metadata` handler called a non-existent store method
  (`get_file_by_filename`), always returning empty metadata. Mobileraker retried
  this thousands of times per second. Both the HTTP and WS paths now share a
  single `_build_file_metadata()` method.
- **Mobileraker: ETA / remaining time not shown (issue #48).** A side effect of
  the metadata loop fix — once `currentFile` resolves, Mobileraker can calculate
  ETA from `estimated_time`.
- **Mobileraker: `notify_status_update` triggered repeated `ConfigFile.parse`
  (issue #48).** Static objects (`configfile`, `webhooks`, `heaters`, `history`)
  were included in every live status push. They are now filtered out; only live
  telemetry is broadcast.
- `motion_report` (`live_position`, `live_velocity`) added to printer objects
  for Mobileraker motion display.
- Saving filament slot profiles no longer silently drops the `visible_vendors`
  setting from `config.ini`.

## [0.9.21] – 2026-06-14

### Fixed
- **Camera stream not visible on Android (Chrome / Firefox).** Android
  browsers do not support `multipart/x-mixed-replace` (MJPEG). The UI
  now detects Android and falls back to snapshot-polling at 5 fps
  (`/api/camera/snapshot` every 200 ms) — no server-side change needed.

### Changed
- Docker image now pinned to **Debian 12 (Bookworm)** (`python:3.11-slim-bookworm`)
  to avoid glibc 2.41 compatibility issues introduced by the Debian 13
  base image that `python:3.11-slim` recently started pulling.
- MQTT and HTTP connections now **force IPv4** (`AF_INET`) to prevent
  connection failures on hosts where the printer is only reachable via
  IPv4 but the OS prefers IPv6.
- Extruder stub in the Moonraker `configfile` response now includes
  `sensor_type` and `filament_diameter` — fixes a Mobileraker crash
  (`Null is not a subtype of Object`, issue #48).

## [0.9.20] – 2026-06-08

### New
- **French language support (PR #45 by @Nathacks)**
- **Z height display in the print UI (PR #49 by @Nathacks).** Shows
  current Z position in mm below the layer counter.

### Fixed
- **Camera auto-start ignored "Enable camera on print start" setting
  after a bridge restart (issue #50).** The setting was cached in the
  process environment — after saving it in the UI, the old value
  survived the restart and the new value from `config.ini` was never
  read.
- **Camera restarted automatically after manual stop during a print
  (issue #50).** A new `_camera_user_stopped` flag suppresses
  auto-restart for the current print session. It resets when the
  print ends.
- **Spurious "stream unavailable" error toast when stopping the camera
  manually.** The image error handler was still registered when
  `img.src` was cleared.
- **JS error (`ReferenceError: br is not defined`) when toggling the
  light.** Variable was referenced from the wrong scope.
- Webcam URLs are now absolute so that Mobileraker/Obico clients can
  reach them.

## [0.9.19.1] – 2026-06-04

### Fixed
- Standalone binaries (Linux/Windows) reported `vunknown` as their
  version. The `VERSION` file is now embedded into the PyInstaller
  onefile bundle.
- When the TLS certificates (`anycubic_slicer.crt`/`.key`) were
  missing, the bridge only logged the raw `[Errno 2] No such file
  or directory`. It now states clearly where the files need to be
  placed and that `anycubic-certs.zip` from the Gitea release is the
  source.

### Changed
- Filament profile list re-curated: 209 entries instead of 399.
  Profiles that only exist inside printer-specific vendor bundles
  (e.g. Eryone Thinker X400, Artillery M1 Pro, WonderMaker ZR,
  Tiertime, Cubicon, CoLiDo, Afinia, Snapmaker) were dropped —
  OrcaSlicer wouldn't have found them in a default Kobra X setup
  anyway, because the matching vendor bundle is only loaded when
  the corresponding printer vendor is active. For those filaments
  the custom profile import (issue #41) remains the way.

## [0.9.19] – 2026-06-02

### New
- **🎯 Filament sync with OrcaSlicer now picks the right preset**
  instead of always falling back to "Generic PLA". Requires an
  OrcaSlicer build with the
  [PR #13719](https://github.com/SoftFever/OrcaSlicer/pull/13719)
  receive-side patch (included in the OrcaSlicer-KX build). The bridge
  sends `name` + `vendor_name` per AMS slot on the lane path AND
  `gate_filament_name` per gate on the Happy-Hare MMU path (OrcaSlicer
  switches to the HH path automatically for AMS setups).
- **Import your own OrcaSlicer profiles into the bridge (issue #41).**
  Settings → "OrcaSlicer Profiles" or directly in the slot-edit dialog
  ("★ Import own profiles…") lets you upload `.json` files from
  `~/.config/OrcaSlicer/user/<id>/filament/` — single files or as a
  ZIP. They show up in the slot dropdown under "★ Own profiles" and
  are passed through to Orca on sync as user matches. Works over HTTP
  so the bridge can run in Docker on a Raspi/NAS while OrcaSlicer
  lives on a desktop. Override-only profiles with just
  `inherits: "Generic PLA @System"` + a few tweaks are detected
  correctly — the bridge resolves the inherited fields from the
  system parent.

### Fixes
- **AMS sync stuck on "Generic PLA":** the Orca data model has 68
  duplicate `filament_id` values (`OGFL99` alone shared by 136
  profiles), and the bridge often picked an ID that was not
  `is_compatible` with the Kobra X (e.g. `GFL92` from the Kobra-2
  profile → Orca rejected it). The generator now prioritises Kobra-X
  variants and filters out phantom profiles (cross-vendor overrides) —
  `orca_filaments.json` dropped from 1035 to 400 clean profiles.
- **Slot without an explicit override now sends `Generic <type>`**
  instead of an implicit vendor guess. Library generic profiles have
  `compatible_printers: []` (= all printers), so they are always
  visible and match reliably.
- **Slot card shows the vendor right after save** without a browser
  reload. `poll()` was async, the re-render only happened on the next
  tick.
- **ACE dryer toggle threw a 502 even though the dryer worked
  (PR #42 by @gangoke):** `setDry` is now fire-and-forget like
  `setAutoFeed`. The printer answers on that push topic with
  `code: 0` instead of `code: 200`, which the bridge wrongly treated
  as an error.

### Data model / API
- `orca_filaments.json` regenerated: only real vendor profiles and
  OrcaFilamentLibrary profiles. Bambu/Polymaker/SUNLU library profiles
  in, Qidi cross-bundles out.
- New endpoints: `POST /kx/filament/profiles/user` (ZIP/JSON upload),
  `GET /kx/filament/profiles/user` (list user imports),
  `DELETE /kx/filament/profiles/user[?vendor=…&name=…]`. Persisted in
  `<KX_DATA_DIR>/orca_filaments.user.json` (volume — survives image
  updates).

### Build
- New module `bridge/orca_filaments.py` (shared parser helpers used by
  the generator and the import endpoint).
- Dockerfile + release.sh updated to include `orca_filaments.py`.

## [0.9.18] – 2026-05-31

### New
- **🎉 Push filament material and colour from the bridge to the
  printer:** The values you pick in the slot-edit dialog now actually
  reach the printer and stick — the printer display shows the same
  slot setup as the bridge UI right away. In 0.9.17 the command was
  sent over the wrong MQTT topic (`slicer/printer/…`) and the printer
  silently dropped it. It now goes via `web/printer/…` like the
  Anycubic Slicer Next does (verified by live MQTT sniff +
  Workbench-Vue source). **Note:** the printer must be idle, and
  empty slots can not be labelled.
- **Spanish translation reviewed by a native speaker (PR #40 by
  @pezfisk):** missing accents (impresión, cámara, después,
  animación, …) and term consistency (Pause → Pausa, Start →
  Iniciar, Layer → Capa). New `README.es.md` and cross-links between
  the three READMEs.
- **Z-height now shows up in Obico.** The printer does not report a
  real Z position over MQTT (live-sniff confirmed), so the bridge
  estimates it from `current_layer × layer_height + first_layer_height`.
  Layer heights are parsed from the gcode header at upload time and
  persisted in the gcode store; fallback for prints started directly
  from the slicer is the OrcaSlicer default filename pattern
  (`…_0.2_…gcode`). `/server/files/metadata` also serves
  `object_height` (total Z) so Obicos `mmProgress` widget can render
  `current Z / total Z`.
- **Slot card shows the OrcaSlicer profile vendor** under the
  material (e.g. `PLA / Polymaker`), with the profile name + internal
  ID as tooltip. Lets you see at a glance which slot override is
  active.

### Fixes
- **Slot profile picker in the AMS dialog (issue #39 by
  @harrygeier):** three separate bugs in 0.9.17 caused the chosen
  brand to disappear after save and a different material to show up
  on re-open.
  - `multiColorBox/setInfo` was sent on the wrong MQTT topic — see
    above.
  - Save fired two parallel requests (profile override + material/
    colour) → race. Now sequential, and the local state is reloaded
    before the dialog closes.
  - OrcaSlicer filament IDs are not unique — `orca_filaments.json`
    has 68 duplicate IDs, `OGFL99` alone is shared by 136 vendor
    profiles (caught by @gangoke). The primary selector is now
    `(vendor, name)` — unique across all 1002 profiles.
- **MQTT reconnect (issue #33 by @icebear):** if the printer was
  powered off overnight the bridge gave up after 5 reconnect attempts
  (~60 s total) — filament sync still worked in the morning (its
  HTTP), but starting a print failed with `connection refused` and
  the user had to restart the bridge itself. The reader thread now
  reconnects **forever** (backoff caps at 60 s) until the printer
  responds again, with logs dropping to DEBUG after the first 5
  attempts so an overnight outage does not spam the log.
- **`Unknown child pid` warnings in the log:** the camera ffmpeg
  helpers were killed without awaiting their `wait()` — children
  lingered as zombies and asyncio reported them every ~20 s. Fixed
  in CameraCache + `/api/camera/stream`.

### UI polish
- **Pause button is now a toggle:** while printing → `⏸ Pause`,
  while paused → `▶ Resume`. The separate resume button is gone.
- **Pause + stop hidden when the printer is idle** — both used to be
  visible at all times, which was confusing on a standby printer.

### Build
- **gcode store migration:** new columns `layer_height` +
  `first_layer_height` on `gcode_files` (added automatically on first
  start of 0.9.18).

## [0.9.17] – 2026-05-30

### New
- **🧪 Obico integration (experimental):** The bridge now exposes a
  Moonraker-compatible surface that the
  [moonraker-obico](https://github.com/TheSpaghettiDetective/moonraker-obico)
  plugin accepts. Time-lapses, layer-aligned first-layer scan and WebRTC
  live streaming work against a (self-hosted or cloud) Obico server.
  **Note:** the spaghetti-detection ML model is trained on side-view
  cameras (Ender/Voron); how well it works with the Kobra X's top-down
  camera is still to be evaluated empirically (it already looked
  promising in our tests). Stream, time-lapse and telemetry work — the
  failure-detection side stays flagged as experimental for now.
- **Multi-language UI (PR #37 by @gangoke):** Inline translations have
  moved into JSON files; a globe-icon dropdown lets you switch language.
  Browser locale is auto-detected; manual choice persists in
  LocalStorage. Languages: 🇩🇪 🇬🇧 🇪🇸 🇨🇳 (ES + ZH-CN are AI-translated
  and not verified by native speakers yet).
- **OrcaSlicer filament profile per AMS slot:** The slot-edit dialog now
  lets you pick a concrete OrcaSlicer profile (e.g. "PolyTerra PLA —
  Polymaker") per slot; the bridge sends it along on AMS sync instead
  of just "Generic PLA". Profile list is generated from the OrcaSlicer
  source (~1000 profiles, 43 vendors). A matching patch in
  OrcaSlicer-KX is on the way so OrcaSlicer fully honours the hint.
- **H.264 direct stream:** New `/api/camera/h264` endpoint serves the
  printer camera stream as MPEG-TS without re-encoding — dramatically
  reduces latency, bridge CPU during Obico streaming drops from ~13 %
  to ~3 %.

### Fixes
- **Setting temperature via bridge UI / Obico caused a printer system
  error:** Fixed via live MQTT capture from Anycubic Slicer Next — the
  `tempature/set` command needs a `type` field (0=nozzle, 1=bed,
  2=both) and must go over the `web/printer/…` topic, not
  `slicer/printer/…`. Nozzle/bed heating from the bridge now works.
- **Large GCode uploads (>50 MB) timed out:** The socket connect timeout
  was active during `sendall()` too — pushing ~200 MB over LAN took
  more than 30 s and was falsely aborted. Connect / send / read phases
  are now timed out separately.
- **Camera snapshots were slow and could collide with the live stream:**
  The bridge now keeps a central camera cache (one ffmpeg pulls from
  the printer, all consumers share it). Snapshots return in ~1.3 ms
  from RAM instead of 1–2 s per spawned ffmpeg. Also resolves the
  single-client limit on the printer (HTTP 429 on parallel access).
- **Language switch did not refresh the GCode browser:** Strings baked
  into the file cards ("Print", "Estimate", "Download") stayed in the
  previous language. Cards are now re-rendered on language switch.
- **GCode web upload + download + verify dialog (PR #32 by @gangoke):**
  Files can be uploaded / downloaded directly in the browser, with a
  warning dialog when starting a GCode that was not uploaded via
  OrcaSlicer.

### CI/Build
- Multi-arch Docker image (amd64 + arm64) automated via Gitea Actions.
- Release builds for all three targets (linux-amd64, linux-arm64,
  windows.exe) via the local CodeBuilder.

## [0.9.16] – 2026-05-22

### New
- **Auto-start camera on print:** new setting "Turn camera on at print start" —
  when enabled, the bridge starts the camera stream automatically when a print
  begins (works for both OrcaSlicer and the Bridge UI).

### Fixes
- **Single-color print blocked by an empty AMS slot:** OrcaSlicer writes all
  configured filaments into the GCode header even when the model uses only one,
  so the bridge told the printer it needed every color — and an empty unused slot
  aborted the print. The bridge now maps only the filaments actually used by the
  GCode.
- **Filament sync now position-accurate:** with an empty slot in the middle
  (e.g. slot 1 yellow, 2 empty, 3 red, 4 white) OrcaSlicer showed the colors
  shifted onto the wrong slots. Fixed — empty slots keep their position, and the
  sync color format follows the Happy Hare convention (RRGGBB without `#`).
- **Slicer time + thumbnail missing after a browser reload** (or when a print was
  started directly from OrcaSlicer): both are now restored from the GCode store
  by filename instead of relying on volatile state.
- **German translation gaps** in the ACE dryer dialog fixed.

### Logging
- Repeated log lines are collapsed into a counter ("×N") instead of spamming the
  console; status-poll traffic is no longer logged at INFO.
- New log level filter (All / Errors / Warnings), a toast on new errors, full
  tracebacks forwarded to the browser log, and a timestamped download filename.

## [0.9.15] – 2026-05-21

### Fixes (Issue #29)
- **UI in the OrcaSlicer device tab was broken:** OrcaSlicer's embedded webview
  only loads the bare HTML and ignores external `<script>`/`<link>` tags, so after
  the v0.9.14 theme split none of the buttons worked in the device tab. The
  bridge now inlines CSS + JS into the page — works in both the browser and the
  OrcaSlicer webview.
- **Dropdowns unreadable (white-on-white) in the OrcaSlicer webview:** added
  `color-scheme` + explicit `select`/`option` colors so the native dropdowns
  render correctly in dark and light theme.
- **"Select slots" button did nothing right after an upload:** a missing variable
  declaration (`storeFiles`) threw a `ReferenceError` when clicked before the
  Browser tab had loaded. Fixed.
- **Upload banner came back after a finished print:** the "file ready" state was
  only cleared on stop/cancel, not on `finished`. Now cleared on completion too.

## [0.9.14] – 2026-05-21

### New
- **Theme system (community contribution by @hirnwunde, PR #27):** the web UI now
  lives in real files under `web/themes/<name>/` (`index.html` + `style.css` +
  `app.js`) instead of being embedded in the Python source. Switch themes with
  `--ui-theme <name>`. Theme authors get a documented hook reference
  (`web/DOC/THEME-CSS-HOOKS.md`, `THEME-JS-ID-HOOKS.md`). The default theme
  carries the full current UI (ACE2, skip objects, filament dialog). No change
  for users — the bundled binaries/Docker image ship the theme embedded.
- **Restart over API (community contribution by @gangoke, PR #28):** new
  `POST /api/restart` endpoint to restart the bridge remotely — e.g. a restart
  button in the Home Assistant integration.

### Internal
- Unified PyInstaller build (`kx-bridge.spec`) for Linux, Windows and Docker —
  embeds `web/` (themes) into the one-file binary, read at runtime from
  `sys._MEIPASS`. Verified the theme ships in the Linux binary and the Windows EXE.
- `data/` added to `.gitignore`.

## [0.9.13] – 2026-05-20

============================================================
  STOP — READ THIS BEFORE PRESSING "UPDATE"
============================================================

The in-app "Update" button is BROKEN in 0.9.11 and 0.9.12.
Do NOT use it. Update manually instead (one time), then it
works again from 0.9.13 onward.

>> WINDOWS .EXE / LINUX BINARY users — DANGER:
   Pressing Update OVERWRITES your kx-bridge.exe / kx-bridge
   with a text file. The program will NOT start anymore.
   It cannot repair itself.
   --> Update manually: download the 0.9.13
       kx-bridge-windows.zip / kx-bridge-linux.zip from the
       Releases page and replace your old file.
       Your config/ and data/ folders are kept.

>> DOCKER users:
   Pressing Update makes the container crash-loop
   (ModuleNotFoundError: No module named '_web_assets').
   --> Update manually:
       docker compose pull  (or  docker compose up -d --build)
       Your config + data volumes are kept.

From 0.9.13 on, the in-app updater is fixed and safe again.
============================================================

### Fixes
- **Self-update was broken in 0.9.11 and 0.9.12 (critical):** the in-app updater
  only replaced `kobrax_moonraker_bridge.py`. Two problems:
  - **Binary/EXE mode:** it overwrote the running executable (`sys.executable`)
    with a Python text file, leaving an unstartable program that can't recover
    itself — manual re-download required.
  - **Python/Docker mode:** since 0.9.12 the main file imports the extracted
    `_web_assets.py` (bundled frontend), which the updater didn't fetch →
    `ModuleNotFoundError: No module named '_web_assets'` → crash loop.
  The updater now downloads **all** bridge modules (main file + `_web_assets.py`
  + client + loaders) fully, then swaps them atomically, and **refuses to
  self-update in binary mode** (pointing you to the manual download instead).

## [0.9.12] – 2026-05-20

### Fixes
- **Pause state** is now read correctly: the bridge was looking at the device-level
  state instead of the nested print-job state, so a paused print sometimes still
  showed as printing. Layer/progress/remaining-time are now also taken from the
  job report.

### Internal
- Frontend (HTML/CSS/JS) extracted from the Python file into `web/index.html`,
  bundled back in at build time — easier to maintain, no change for users.

### Docs
- Linked the community **Home Assistant integration** by @gangoke.

## [0.9.11] – 2026-05-20

### New
- **ACE Pro 2 support (experimental, community contribution by @gangoke, PR #26):** the bridge now auto-detects the filament hardware and adapts:
  - **Modes:** `toolhead` (no ACE, stock 4-slot box), `ace_direct` (one ACE Pro 2 directly on the toolhead), `ace_hub` (up to 4 ACE units on the slot-4 hub) — up to **19 slots** total.
  - **AMS auto-refill** toggle.
  - **Dryer:** temperature/humidity monitor, start/stop/temp/duration control, with material presets configurable in a new `[ace_dry_presets]` config section (PLA, PLA+, PETG, TPU, ABS/ASA, PA/PC + 3 custom).
  - **UI:** filament section scales to 19 slots, mode label, loaded slot is green-outlined with a load/unload pulse animation, unload/load straight from the slot-edit dialog.
  - **GCode color mapping:** ACE2-aware, color-from-GCode fix, inconsistency notifier when the mapping doesn't match the objects, better default mapping.

> **⚠️ Experimental:** the ACE Pro 2 hardware paths were developed and tested by the contributor with a single ACE2 unit; the 2–4 unit hub configurations are theoretical and untested on real hardware. We don't have ACE2 hardware to verify against either. The standard `toolhead` (no-ACE) path was verified live against a real Kobra X here. If you run a multi-ACE setup, please report back via Issues.

### Fixes
- **Happy Hare MMU emulation:** only populated slots are now synced — no placeholder for empty slots (aligns with OrcaSlicer PR #13372).
- **GCode color dialog** no longer shows the previously-uploaded file's data after a new upload.

---

## [0.9.10] – 2026-05-17

> **Heads-up:** with this release the focus shifts from new features to
> **stabilization and bug-fixing**. The core flows (multi-printer, add/remove,
> filament dialog, skip objects, standalone binaries) are feature-complete
> enough — from now on the priority is making them rock-solid before adding
> more on top. Bigger feature requests (ACE Pro 2, Home Assistant integration
> completeness, …) stay on the backlog for now.

### New
- **Skip objects (pre-print and mid-print):** Reverse-engineered from the AnycubicSlicerNext Workbench bundle — the Kobra X actually supports object skipping over its native protocol, but the Anycubic slicer doesn't expose it. The bridge does now, in both flavors:
  - **Pre-print:** when starting a multi-object print from the Browser tab, the filament dialog now has an additional "Objects" section. Uncheck individual objects (or click the polygon directly on the build-plate SVG preview) and they're stripped from the print before it starts.
  - **Mid-print:** new ✂ button on the dashboard (only visible during an active print). Opens a dialog with the same interactive SVG preview — click a part to mark it for skipping, hit confirm, and the printer drops it from the rest of the run. Already-skipped parts stay greyed out and the dialog refreshes live so you can see which ones are gone.
- **Filament dialog – colored channel and slot markers (Issue #23):** the GCode channel number now sits in a colored box on the left (background = channel color, auto-contrast text instead of the old tiny dot), and the assigned AMS slot gets the same treatment on the right of the dropdown — updates live as you change the selection. Plays well with 4 channels; the layout iterates so more channels render correctly, but >4 actual filament slots still need an ACE Pro 2 hub to be testable end-to-end (parked as a feature request, Issues #22 and #23).

### Internal
- New `kobrax_client.skip_objects(names)` / `query_skip_objects()` helpers.
- New endpoints: `GET /kx/files/{id}/objects`, `POST /kx/skip`, `POST /kx/skip/query`, `GET /kx/skip/state`.
- SQLite schema: `gcode_files` gained `objects_skip_parts` and `svg_image` columns (auto-migrates on existing DBs).
- `_on_file` now extracts the printer-provided object list + SVG preview and persists them per file.
- `_on_skip` callback tracks which objects the printer reports as currently skipped.

---

## [0.9.9] – 2026-05-14

### Fixes
- **"Failed to fetch" loop in the UI (Issue #21):** When the web UI was opened via the LAN IP, `/kx/printers` was returning `bridge_url: http://localhost:7125`, which caused the browser to fire cross-origin requests from the LAN IP to `localhost` — these were silently blocked, producing a flood of `TypeError: Failed to fetch` poll errors. The bridge now sends an empty `bridge_url` in single-printer mode so the frontend uses relative paths against the same origin as the UI. In multi-printer mode, `localhost`/`127.0.0.1` are filtered out as bridge hosts.
- **Windows EXE startup crash (Issue #21):** The v0.9.8 `kx-bridge.exe` was built with a stale `config_loader.py` from an earlier release and crashed on startup with `AttributeError: module 'config_loader' has no attribute 'list_printers'`. `release.sh` now syncs `config_loader.py` into the Windows build repository together with the other source files.

---

## [0.9.8] – 2026-05-12

### New
- **Multi-printer in a single bridge instance:** One process now manages multiple printers — N MQTT connections + N HTTP listeners (ports 7125, 7126, …), shared SQLite + GCode store. Configure via `[printer_1]`, `[printer_2]` … sections in `config.ini`. Single-printer mode (`[connection]` only) keeps working unchanged. `docker-compose.yml` exposes a port range `7125-7130`.
- **Add printer from the UI:** "+ Add printer" button in the Printers tab — just enter the printer IP, the credentials (username, password, device ID) are fetched and decrypted from the printer automatically. Adding more printers assigns the next free port (7126, 7127, …).
- **Remove printer from the UI:** "✕" button on each printer card with a confirmation dialog — removes the `[printer_N]` section and renumbers the rest. Removing the last printer clears `[connection]` too, leaving an empty state.
- **GCode Store:** Uploaded files are persisted in SQLite with thumbnail extraction. New `/kx/files` API.
- **Browser tab:** Grid view of all uploaded files — thumbnail, status badge (✓/✗), last print duration, plus search, filter and sort.
- **Print history:** Print jobs (start/end/status) are recorded in SQLite, status shown per file in the Browser tab.
- **Filament dialog:** Per-channel remapping before print start — assign each GCode color channel to a physical AMS slot (like the Anycubic Slicer does). Available in the Browser tab and the upload banner.
- **MMU emulation:** `GET /printer/objects/query?mmu` returns a Happy-Hare-compatible structure so OrcaSlicer's filament sync detects the AMS slots.
- **Printers tab:** Live status of all printer instances, IP shown on each card, "Switch →" button.
- **Editable printer name:** Set a custom name in Settings (stored in `[bridge] printer_name`, takes precedence over the MQTT-reported name).
- **Standalone friendly:** Linux binary / Windows EXE run without Docker — `config/` and `data/` are placed next to the executable (portable). First start with no printer configured shows the Printers tab with "+ Add printer" instead of the settings modal.
- **i18n:** All new UI elements available in German and English.

### Fixes
- **CORS:** CORS middleware added to all endpoints — cross-instance fetches in the multi-printer UI work reliably.
- **Settings / update check** now reflect the active bridge instance in multi-printer mode (via `_apiUrl`).
- **Bridge restart:** Config-dependent environment variables are cleared before a restart (the config loader cached them, which made config changes invisible until the next cold start). Restart is now platform-aware: Docker/systemd → process exit (supervisor restarts), Linux standalone → `os.execv`, Windows → detached subprocess.
- **`--data-dir` default** is now platform-dependent — the `/app/data` default only applies inside Docker (set via `ENV`), standalone binaries use `<exe-dir>/data`. Fixes a startup crash when running the binary without Docker.

---

## [0.9.7] – 2026-05-08

### New
- **fetch_credentials tool:** Fetches and decrypts MQTT credentials directly from the printer via HTTP — no running Anycubic Slicer required, only the printer IP needed. Linux binary and Windows EXE included in release. (Contributed by bebu, PR #19)

### Fixes
- **Large GCode upload:** Files >1 MB were rejected with HTTP 413 — aiohttp `client_max_size` raised to 256 MB
- **Upload timeout:** Socket timeout after GCode upload raised from 10s to 120s — large files caused the bridge to crash with an empty response while the printer was still processing

---

## [0.9.6] – 2026-05-02

### New
- **Light status sync:** Light on/off state and brightness are now read live from the printer via `light/report` MQTT message — the light toggle in the UI reflects the actual printer state
- **Time mini-cards:** Progress panel now shows three cards — Elapsed, Remaining and Slicer estimate — with a layer counter badge next to the progress bar
- **Slicer estimate from GCode:** Estimated print time is parsed directly from the uploaded GCode file (OrcaSlicer: `; total estimated time:` at end of file, PrusaSlicer: `; estimated printing time` in header)
- **Extended printer status strings:** Added `pausing`, `paused`, `resuming`, `resumed`, `stopping`, `stopped` states — previously missing, causing the UI to show raw status codes during pause/resume/stop transitions

### Fixes
- **file_ready banner:** Upload banner is no longer shown after print stop or cancel
- **Timers on stop/cancel:** Elapsed, remaining and slicer estimate times are reset to zero when a print is stopped or cancelled
- **start.sh:** `config/` directory and `config.ini.example` are now created automatically on first run if missing (Issue #15)

---

## [0.9.5] – 2026-05-01

### New
- **Upload banner:** After "Upload only", a green banner appears with the filename — "▶ Start Print" starts the print directly, "✕ Cancel" dismisses the banner

### Fixes
- **Auto-print:** `auto_print` was always reset to `False` after the multipart loop — OrcaSlicer "Upload and print" never started the print automatically
- **Thumbnail:** Preview image is now shown after "Upload only" — bridge requests `fileDetails` immediately after upload
- **Log auto-scroll:** Scroll position is preserved when auto-scroll is disabled — no more unwanted jump to top

---

## [0.9.4] – 2026-05-01

### New
- **AMS slot editor:** Click any slot in the AMS panel to open an edit dialog — set color (color picker) and material (preset buttons: PLA/PETG/ABS/ASA/TPU/PA/PC/HIPS or free text) directly from the browser
- **Improved log panel:** Full MQTT payloads (no truncation), direction filter (All/RX/TX) and topic quick-filter buttons (AMS / print / info / status)

### Fixes
- **i18n:** Camera placeholder text and log direction "All" button now correctly translated on language switch

---

## [0.9.3] – 2026-05-01

### Fixes
- **Update check:** Stable users no longer receive dev pre-releases — `STABLE_RELEASE_API` had `pre-release=true` which caused stable installs to find dev builds instead of stable releases (Issue #14)
- **Version after update:** `VERSION` file is now included in the Docker image (`COPY VERSION .`) — `_write_version()` requires the file to exist, without it the version was never updated after self-update (Issue #14)

### New
- **Version in header:** Running version shown in the Web-UI header next to the printer name — no need to open Settings to check (Issue #14)

---

## [0.9.2] – 2026-04-29

### ⚠️ Breaking Change: Configuration moves from `.env` to `config/config.ini`

**Migration is automatic** on first start — no manual action required.

- Settings are now read from `config/config.ini` instead of `.env`
- On first start without `config.ini`, the file is created automatically from `.env`
- **Docker:** Volume `./config:/app/config` in `docker-compose.yml` is the persistent storage — settings survive `docker-compose restart` and updates
- **Standalone:** `config/config.ini` sits next to the binary and is not overwritten on update
- `.env` stays mounted read-only as a migration source — you can leave it in place
- To create a `config.ini` manually: copy `config/config.ini.example`

### New
- **Persistent settings:** `config/config.ini` replaces `.env` — settings no longer lost after `docker-compose restart` (Issue #9)
- **Connection error banner:** Red banner at the top of the Web-UI when MQTT connection fails (e.g. wrong password, printer unreachable) (Issue #11)
- **Slicer estimated time:** Estimated total print time from GCode header shown in the progress panel

### Fixes
- README: OrcaSlicer connection documented explicitly with `http://` and port `:7125` (Issue #12)
- README: Direct download link for `extract_credentials` pointing to Gitea releases (Issue #13)

---

## [0.9.1-dev] – ongoing (dev branch)

### New
- **Dev branch infrastructure:** Version scheme `0.9.1-dev+<hash>` — every build uniquely identifiable
- **Separate update channel:** Dev versions check for Gitea pre-releases with `-dev+` in the tag
- **AMS slot selection:** Setting "Default slot (single color)" in the Settings modal — pins a specific AMS channel or Auto (all loaded slots)
- **Auto-leveling:** Checkbox in Settings modal — controls `task_settings.auto_leveling` on print start
- **MQTT logging:** Structured TX/RX log with duplicate filter (`kobrax.mqtt` logger)
- **Server log in browser console:** Live stream via SSE (`/api/log/stream`) — all server logs appear in the Log tab
- **Log tab improvements:**
  - Auto-scroll on/off — disables automatically on manual scroll-up, button to re-enable
  - Text filter — live filtering of log entries
  - Error badge — red counter on the tab button when errors/warnings occur while on another tab
  - Clear button — empty the buffer
  - Download button — last 500 entries as `kx-bridge.log`
  - Log window now fills all available space (instead of fixed 160px height)
- **Log buffer:** 500 entries (server + browser unified)
- **Changelog in update dialog:** Release notes from Gitea loaded and shown directly in the update dialog
- **Slicer estimated time:** Estimated total print time from GCode header shown in the progress panel

---

## [0.9.1-beta15] – 2026-04-26

### Fixes
- AMS: Empty slots are skipped on print start — no more `filament runout` for unloaded channels (Issue #5)
- AMS: Material type is now correctly read from the printer protocol (field `type` instead of `material_type`)
- AMS UI: Empty slots shown grey/transparent with "Empty" label

---

## [0.9.1-beta14] – 2026-04-26

### Fixes
- Z axis: ▲ now moves up (Z+), ▼ moves down (Z−) — arrows were reversed (Issue #4)
- Home All: correct axis code 5 — homes all axes XYZ (Issue #4)
- New "Home XY" button (axis=4) in the UI
- New "Motors Off" button (axis turnOff) in the UI

---

## [0.9.1-beta13] – 2026-04-26

### Fixes (Windows)
- Self-update / Settings restart: `os.execv` now works correctly in PyInstaller binary
- Camera: `ffmpeg not found` no longer crashes — clean 503 response when ffmpeg is not installed
- Reconnect loop: Short empty TCP reads on Windows no longer trigger immediate reconnects

### Structure
- `bridge/`: Bridge files extracted from `05_scripts/`
- `tools/`: `extract_credentials.py` as standalone tool with its own README
- `_archive/`: RE research folders, analysis tools and old release checksums archived
- README fully rewritten: clear 3-step quick start

---

## [0.9.1-beta12] – 2026-04-25

### Fixes
- Wrong MQTT credentials now shows a human-readable error instead of cryptic `CONNACK failed: 20020005`

---

## [0.9.1-beta11] – 2026-04-25

### Fixes
- Printer IP is automatically cleaned if the user accidentally includes the port (e.g. `192.168.1.102:9883` → `192.168.1.102`)
- Settings modal: hint shown when `:` is detected in the IP field
- `docker-compose.yml`: `.env` mounted as volume into the container — settings persist after `docker-compose restart`

---

## [0.9.1-beta10] – 2026-04-25

### New
- `start.sh` — starts the bridge via Docker, builds the image automatically on first run
- Tests: pytest suite (19 tests) for API state, Moonraker endpoints, settings; install smoke test (`test_install.sh`)
- Settings modal opens automatically on first start when no credentials are configured

### Changed
- README: Quick start now shows `./start.sh` instead of manual `docker build`
- README: LAN mode correctly described as a printer menu option
- README: Version number now updated automatically on each release
- `extract_credentials`: `--write-env` no longer recommended — enter values in the ⚙ menu
- Dockerfile in release repo: paths without `05_scripts/` prefix
- `release.sh`: Dockerfile for release repo automatically patched via `sed`

### Fixes
- Remaining print time (`remain_time`) now correctly taken from `print/report` and shown in UI
- Translation: "Step size" and "Target" placeholders in temperature inputs now correctly translated

---

## [0.9.1-beta9] – 2026-04-25

### New
- OrcaSlicer profile (`kobra_x_orcaslicer_preset.zip`) as release asset
- `release.sh`: OrcaSlicer profile automatically copied to release repo and uploaded

### Changed
- README: `extract_credentials` without `--write-env`, values entered manually in the ⚙ menu
- README: Docker quick start simplified

---

## [0.9.1-beta8] – 2026-04-25

### New
- Remaining print time display in UI (≈ Xh Ym remaining) from `remain_time` field
- Settings modal: connection settings and self-update directly in the browser
- Self-update: bridge checks Gitea release API for new versions and updates itself

### Changed
- Bridge starts in offline mode when printer is unreachable (no crash)
- Connect/Disconnect button in header

---

## [0.9.1-beta7] – 2026-04-22

### New
- Offline start: bridge runs without MQTT connection, reconnects automatically when printer is reachable
- Connect/Disconnect button in header

---

## [0.9.1-beta6] – 2026-04-20

### New
- Release ZIPs: `kx-bridge-linux.zip`, `kx-bridge-windows.zip`, `anycubic-certs.zip` with certificates

### Fixes
- PyInstaller frozen binary: `__file__` replaced with `sys.executable` path (cert path fix)

---

## [0.9.1-beta5] – 2026-04-19

### New
- `kx-bridge.exe` (Windows) built automatically via GitHub Actions

---

## [0.9.1-beta4] – 2026-04-18

### New
- `release.sh`: builds Linux binary and Windows EXE, uploads all assets to Gitea
- English README (`README.en.md`)

### Fixes
- `progress` and `filename` correctly reset to 0 on `stoped`/`canceled`

---

## [0.9.1-beta3] – 2026-04-17

### New
- Print speed card (Silent / Normal / Sport)
- Translations (DE/EN) completed

---

## [0.9.1-beta2] – 2026-04-17

### Fixes
- Temperature control during an active print

---

## [0.9.1-beta1] – 2026-04-17

### New
- Complete UI overhaul: Settings modal, self-update, dashboard, responsive design
- New printer states: `pausing`, `paused`, `resuming`, `resumed`, `stopping`
- `release.sh`: version bump and release sync script

---

## [0.9.0-beta1] – 2026-04-10

### New
- First public release
- Docker deployment, Linux binary, `extract_credentials` tool
- Moonraker-compatible HTTP/WebSocket bridge for the Anycubic Kobra X
- AMS load/unload, light and fan control
- Web-UI with dashboard, temperature cards, motion control