Note
This is a daily beta build (2026-07-11). It contains the latest fixes and improvements but may have undiscovered issues.
Docker users: Update by pulling the new image:
docker pull ghcr.io/maziggy/bambuddy:daily
or
docker pull maziggy/bambuddy:daily
**Tip:** Use [Watchtower](https://containrrr.dev/watchtower/) to automatically update when new daily builds are pushed.
Fixed
- Energy Summary stuck at zero for Yesterday and Total on REST smart plugs — and the Statistics energy figure with it (#2539, reporter R3play210) — A Shelly Plug S Gen3 wired up over the REST integration showed live power and a Today figure that climbed, but Yesterday and Total never moved off zero, through five days of printing. The bug.
RESTSmartPlugService.get_energy()returned a dict with two keys,powerandtoday. It never setyesterdayortotalat all, soSmartPlugEnergydefaulted them to null and the summary card summed nothing. Tasmota returns all three; Home Assistant returns two; REST returned one. The number that looked right was also wrong. A Shelly has no notion of "today" — its only energy figure isaenergy.total, a lifetime counter in watt-hours that climbs forever and never resets. Bambuddy had a single energy field, so the reporter put the lifetime counter in it, and line 230 filed it undertoday. It looked correct because it grows; it just never dropped back to zero at midnight. The one figure he trusted was the least trustworthy of the four. It broke more than the card. Withtotalnever populated, the hourly snapshot recorder skipped the plug outright (its own comment said so: "REST plugs that only expose today can't be used for cumulative snapshots"),_sum_live_plug_totals()summed zero, and since the reporter'senergy_tracking_modeistotal, the Statistics page's energy figure was zero too — he simply hadn't got to it yet. The fix. A REST plug now says which counter it has:rest_energy_pathstill means "energy used today", and a newrest_energy_total_pathmeans "lifetime counter that never resets". A Shelly has only the latter; a Tasmota behind a REST bridge has both; both are read from one HTTP fetch when they share a URL. Then, because the snapshot table already records that lifetime counter hourly, Today and Yesterday are derived from it: today = the counter now minus its value at the last local midnight, yesterday = that midnight's value minus the one before. So a Shelly gets all four numbers with no new device capability — and Home Assistant's permanently-null Yesterday is fixed for free. Today appears after the first midnight the install lives through, Yesterday after the second; a counter that goes backwards (factory reset zeroesaenergy.total) reports nothing rather than a negative. Local midnight, not UTC. WithTZ=Europe/Berlina UTC boundary would roll Today over at 02:00 wall-clock. The snapshot loop now ticks on the local hour instead of every 3600s from boot, so a reading lands exactly on the day boundary — including in the half-hour-offset zones (India, Nepal) where local midnight isn't on a UTC hour at all. Previously the last snapshot before midnight could be up to an hour early, and an hour of a printer's draw is real watt-hours to lose off the day. Collateral: the whole smart-plug subsystem was broken on Postgres. EveryDateTimecolumn in the smart-plug tables is naive and holds UTC, but the code wrote aware datetimes into them. SQLite tolerates that — its bind processor reads the fields and drops the offset — which is why it went unnoticed. asyncpg does not: it raisesDataError: invalid input for query argument. So on Postgres every energy-snapshot capture raised (silently, inside the loop'sexcept), leaving the snapshot table empty and the date-filtered energy stat permanently zero, and every plug status poll raised onlast_checked. Postgres is what Bambuddy recommends for multi-printer installs, so this was not a corner. All smart-plug timestamps are now naive UTC via a sharedutcnow_naive()/to_naive_utc(), and the snapshot-delta query normalises its bounds the same way. Tests. 8 cases on the derivation (today and yesterday from the counter; yesterday absent until two midnights have passed; nothing derivable before the first; a counter reset reports nothing rather than a negative; another plug's snapshots are not borrowed; a device-reported figure is never overwritten by our arithmetic). 4 on the REST driver, using the reporter's ownSwitch.GetStatuspayload (the lifetime counter lands intotaland not intoday; a plug reporting both keeps them apart; a total path alone is enough to read energy at all; both counters share one HTTP fetch). 4 more pin the Postgres-unsafe datetime — mutation-verified: reintroducing the aware timestamp fails the guard. Migration applied and re-applied against a real Postgres to confirm it is idempotent and defaults to NULL. Existing REST users: if your Energy JSON Path points at a cumulative counter (anything from a Shelly does), move it to the new Energy JSON Path (lifetime) field — the form and the wiki now say which field wants which counter.
Added
- Cam Wall on its own URL, and on a TV that isn't logged in (#2531, reporter cadtoolbox) — The Cam Wall was reachable exactly one way: click the Cam wall button on the Printers page. It had no URL, so you couldn't bookmark it, link to it, or point a wall-mounted screen at it. It now lives at
/camwall, and a button next to the Cards / Cam wall toggle opens it there. Signed in, that page is the same wall you already know — tiles clickable, settings popover working, the knobs shared with the Printers page through the same localStorage keys, so a change in one follows you to the other. The TV case is the hard half. A screen in a workshop has no login session, and a wall tile needs two things a camera token could not previously fetch: the list of printers, and each one's status for the state badge. Both sit behindPRINTERS_READ, so a kiosk got a 401 and an empty wall. The obvious fix — let the existingcamera_streamtoken through toGET /printers— is the wrong one: that response carries every printer'sserial_numberandip_addresseven in its non-secret shape, and a URL pinned to a lobby TV lives in the browser history, in the kiosk's config file, and on the screen itself. So the Cam Wall gets a purpose-built read-only feed atGET /api/v1/camwall/printersthat serves only what a tile draws: id, name, camera rotation, connected, state, progress, layers, remaining time, HMS codes. No serial. No IP. No access code. And no filename — a token wall renders the compact overlay, so the field simply isn't served rather than being served and then hidden client-side; the part on the bed is never named to a room anyone can walk into. A second scope, not a wider one. The feed is gated on a newcamwalltoken scope alongsidecamera_stream. A Cam Wall token reaches the video and the tile metadata; a camera-stream token reaches the video and is refused by the feed. That matters becausecamera_streamtokens are already in the wild, minted by people who agreed to hand out a picture — shipping this must not retroactively grant them the ability to enumerate a fleet by name. Pick the scope when you create the token in Settings → API Keys → Camera API Tokens; the create dialog then hands you the finished kiosk URL, fully assembled, so nobody has to build it from the docs. What a token wall gives up. No settings popover and no click-through: a TV has nobody standing at it, and click-through would open a page the token cannot authenticate. The controls are not merely hidden — they aren't rendered, so a kiosk carries no focusable control it cannot act on. The overlay is capped atcompacteven if the URL asks forfull. The screen can still be tuned from the URL:?maxLive=9&interval=10&status=compact, all clamped to the same ranges the popover enforces. Statuses are polled, not pushed — the page renders outside the app layout and its WebSocket provider, and a kiosk token cannot mint a WS ticket anyway; a wall is watched, not operated, so a 5-second cadence costs nothing. Revoking the token cuts the display off on its next request. Tests. 11 backend cases: no token / garbage token / revoked token all rejected; acamera_streamtoken refused by the feed (the assertion the separate scope exists for); acamwalltoken accepted; the payload's key set pinned so a future field can't quietly add a serial, an IP or a filename; a Cam Wall token passes the camera-stream gate so its own tiles fill; a camera-stream token still passes its own gate (regression guard on #1108); and the scope allowlist pinned so adding a third scope has to be a deliberate act. 7 frontend cases covering the kiosk feed being called with the URL token, the token reaching the<img>URLs, no settings popover, inert tiles,?status=fullrefused, the expired-token message, and — the negative — a tokenless visit never touching the kiosk endpoint. Scope. New endpoint, new token scope, new route. No DB migration, no new permission, no change to the in-page wall. - Live print progress for Virtual Printers in Bambu Studio / OrcaSlicer (#1887, reporter YozenPL) — Connect the slicer to a server-mode VP with a target printer bound and the Device tab shows the printer's AMS, temperatures and camera, but the print itself reads as a name and nothing else: no stage, no percentage, no layer count, no time remaining. The data was never missing — the bridge has the target's real
push_statuscached,mc_percentand all — Bambuddy was deliberately overwriting it with zeros. Why it was zeroed. #1558, the exact inverse complaint: a queue-mode VP that passed the live values through was read by Bambu Studio as busy, and the Send button went away for as long as the printer printed, which defeats the entire purpose of queueing. Why you cannot simply have both. Both slicers gate the Device-tab progress panel and the Send button on one and the same predicate —MachineObject::is_in_printing(), true whengcode_stateis RUNNING / PAUSE / SLICING / PREPARE.StatusPanel::update_subtask()draws the progress bar on it;SelectMachineDialog::update_show_status()disables Send on it. Report the printer's state honestly and you get progress at the cost of Send; zero it and you get Send at the cost of progress. There is no field-level trick, because it is one boolean. The fix. There is exactly one state in the gap:FINISH. StatusPanel renders the full progress panel for it (is_in_printing() || print_status == "FINISH"), SelectMachineDialog does not consider it busy. The VP already parks there after every upload — that is the #1280 / #1658 send-modal handshake — which is precisely why the reporter saw a file name and no numbers: the slicer was already drawing the widget, and we were feeding it zeros. So while the target printer is printing and the VP has no upload of its own in flight, the report now holdsgcode_state=FINISHand passes the realmc_print_stage,mc_percent,mc_remaining_time,stg,stg_cur,layer_numandtotal_layer_numthrough underneath it, at the existing 1 Hz push. Send stays enabled in every mode and #1558 does not come back. What it costs. The slicer's Pause / Resume / Stop buttons stay greyed for a server-mode VP, since it now reports a finished job rather than a running one — they were greyed before this change too, so nothing is lost; drive the print from Bambuddy, or use Proxy Mode, where the slicer talks to the printer directly and they work.print_erroris never mirrored either: a fault on the printer would raise a modal error dialog in the slicer for a machine that did not throw it, and the printer's own card already reports it. The upload handshake wins. Mirroring is suppressed while a job is being handed over (gcode_state=PREPARE) and for five seconds after the last upload transition — the slicer only releases its in-flight-job lock when it sees FINISH carrying thesubtask_nameit just uploaded, so swapping in the printer's filename mid-handshake would wedge the send modal at "Downloading". Once settled, the report switches to the job that is actually on the bed, which is the one the user wants to watch. Tests. 8 cases: progress mirrors while the target prints; the mirrored state is never one the slicer reads as busy (parametrised over RUNNING and PAUSE — this is the assertion that keeps #1558 fixed); progress stays zeroed while the target is idle, while an upload is in flight, and inside the settle window, where the slicer's own filename is still echoed back at it; mirroring resumes once the handshake has settled;print_erroris suppressed while the rest still mirrors. Verified by mutation — forcing the mirror off fails five of the eight. Scope. Backend only, non-proxy VPs with a target printer bound. No DB migration, no schema change, no new setting, no new permission, no i18n change. - Slicer Pipelines — multi-copy batches, class targeting, fanout strategies, runs dashboard, retry-failed, live WS updates (#1425 PR C — completes the v3 design) — The PR A/B drop turned slice-modal preset bundles into one-click dispatches with a pinned target printer. PR C closes the original issue with full production-batch semantics: an operator picks a saved pipeline, types in a number of copies, and Bambuddy slices once and distributes the prints across a fleet according to the pipeline's chosen fanout strategy. The runs dashboard surfaces every active and historical run with filters, per-row expandable per-copy status, cancel-in-flight, and retry-failed-copies. WebSocket pushes keep the dashboard and the in-Settings "Last run" chip live without polling. Backend.
PipelineRunCreateRequest.copies(Pydanticge=1, le=1000) replaces the implicit 1 from PR B; the orchestration loop creates onePipelineJobrow per copy.SlicerPipelineUpdateacceptstarget_kind(specific_printer/printer_class),target_model_class(Bambu model code: A1 / A1 Mini / P1P / P1S / P2S / X1 / X1C / X1E / H2D / H2D Pro / H2C / X2D), andfanout_strategy(max_parallel/round_robin/fill_one_first). A newpipeline_max_copiessetting (default 50, Pydanticge=1, le=1000) gates the copies input in the Run-with-pipeline modal and is enforced again atPOST /runtime so an API caller can't bypass the cap. PR C also addsPipelineRun.parent_run_id(nullable FK to itself, ON DELETE SET NULL) so retry runs link back to the run whose failed copies they re-attempt. Eligibility for class targeting. The matcher inservices/pipeline_eligibility.pynow branches onpipeline.target_kind: the specific-printer path is unchanged (PR B parity), the new class-targeting path enumerates everyPrinterwhosemodelmatchespipeline.target_model_class, runs the per-printer slot-by-slot check for each via astatus_lookupclosure that the route handler hands in (so the matcher stays pure-ish for unit tests), and returns a top-levelprinter_reports: list[PerPrinterReport]withokderived asanyacross the candidates. New issue kinds:no_class_matches(the install has zero printers in the chosen model class) andclass_not_set(target_kind isprinter_classbut no model was picked). The lenient-policy story is the same — operators canRun anywaypast blocking issues, andPipelineRun.eligibility_overriddenis set so the audit trail shows it. Orchestration + fanout. A new_pick_assignments(pipeline, copies)helper returns[(printer_id_or_None, target_model_or_None), …]of length copies per the picked strategy.max_parallelsetstarget_model=pipeline.target_model_classon every queue item and leavesprinter_id=None— the existing print scheduler's model-based dispatch picks any idle matching printer per item; the result is that multiple printers grab work in parallel without any new scheduler code.round_robinenumerates eligible printers (is_active=True, model matches) ordered by id and assigns copyitoeligible[i % len(eligible)]— each item gets a fixedprinter_id, the wear distributes evenly.fill_one_firstpins every copy toeligible[0]so a one-printer fleet stays one-printer even when others come online mid-run; the documented trade-off is that a printer failure freezes the queue at that printer until the operator intervenes. All three flows reuse the same slice-once path; the slice runs throughslice_dispatch.enqueueexactly as PR B did so the persistent progress toast renders end-to-end for batches just like single-copy runs. Routes.GET /pipeline-runs?limit&offset&pipeline_id&statusis the dashboard endpoint — newest-first, paginated, filterable by pipeline and persisted snapshot status.POST /pipeline-runs/{id}/retry-failedcounts the parent's failed-or-cancelled jobs at the live (queue-entry-aware) status level, builds a freshPipelineRunCreateRequestwithcopies=that countandforce=True(operator already accepted eligibility on the parent), routes it through the existingrun_pipelinehandler, and stampsparent_run_idon the result. Returns 400 when the parent's source or pipeline was deleted, or when there are no failed copies to retry.POST /pipeline-runs/{id}/cancelextends PR B's cancel to cascade across N queue entries — only the ones still inpending/queuedare touched so in-flight prints continue on the printer (operator must Stop on the machine). WebSocket. Newpipeline_run_updatedevent type carries the full materialisedPipelineRunResponseand fires on every state transition (queued → slicing → dispatching → in_progress → completed | failed | partial_failure | cancelled). Per-user routing viaws_manager.broadcast_to_user(run.created_by, …)so each operator sees their own runs without cross-user noise; auth-disabled installs broadcast to all connections (PR B's pattern). The frontend'suseWebSocketswitch handles it by invalidating both['pipeline-runs-all'](the dashboard) and['pipeline-runs', pipeline_id](the per-pipeline "Last run" chip in Settings). The dashboard still polls every 15 s as a belt-and-suspenders for missed messages. Run status roll-up. A new_roll_up_run_statusfunction computes the run-level status from the per-job statuses at read time: all-completed →completed, any in-flight →in_progress, some completed + some failed → the newpartial_failurestatus (this is what gets the Retry-failed button), all failed →failed. The persisted snapshot is still written on terminal transitions for the dashboard's status filter to remain useful.copies_completed/_failed/_cancelled/_in_progresscounts ride on the response so per-row "1/3 · 2 failed" summaries don't need a second query. Frontend. The Settings → Workflow → Pipelines pipeline editor grows three new controls in the edit form: a radio fortarget_kind(Specific printer / Printer class), a model-class picker filtered to the models present on at least one installedPrinterrow (so users can't pick "H2C" if they only have X1Cs), and a fanout-strategy radio with the three options labelled with their use cases. The read-only row reflects class targeting with a "X1C · Round robin" line in place of the printer name.RunWithPipelineModalgrows a number input for copies bounded bysettings.pipeline_max_copies, accepts class-targeted pipelines (the "Apply pipeline" button is enabled when the pipeline has either a pinned printer OR a class target), and the pipeline-list row shows "Any X1C" instead of a printer name for class pipelines. The "Run pipeline" Setting → Workflow → Queue & Dispatch sub-tab gets a new "Slicer Pipeline limits" card with the max-copies input (bounded 1–1000 client-side, server enforces the same). New dashboard page at/pipelines/runs(sidebar entry under Print Queue, gated onpipelines:read). Lists every run across every pipeline with two dropdown filters (pipeline + persisted snapshot status) and pagination at 25 per page. Each row shows pipeline name, status chip (partial_failureis amber), source file, created-at timestamp, and "{completed}/{copies}" + "{failed} failed" rollup. Click the chevron to expand a per-copy panel listing eachPipelineJob's assigned printer + status + error message. In-flight runs get a Cancel button; partial-failure / failed runs get a Retry-failed button. i18n. ~43 new keys acrossnav.pipelineRuns,pipelineRuns.*(title / filters / pagination / job-status chips / toasts),settings.pipelines.field.*(targetKind / fanout / class),settings.pipelines.runs.status.partial_failure,settings.pipelineLimits.*,library.runWithPipeline.*(copies / copiesHint / classTarget / issue.noClassMatches / issue.classNotSet), andcommon.previous/common.next— translated in all 11 locales (de / en / es / fr / it / ja / ko / pt-BR / tr / zh-CN / zh-TW). Parity check 5516 leaves per locale, no English fallback.Copies/{{n}} copies/max {{n}}added to the French + Italian cognate allowlists where they're genuine. Tests. Six new backend cases intest_pipeline_runs_api.pycovering copies-cap rejection (schema gate at 1000), 3-copy run creates 3 jobs with sequentialcopy_index, class eligibility with two X1C candidates returns a 2-entryprinter_reportsarray, class eligibility with no matching printers in install returnsno_class_matches, dashboard list endpoint with pagination + status filter, retry-failed correctly counts failed jobs from a partial-failure parent and stampsparent_run_id. Plus the existing 16 PR A/B cases were lightly updated whereclass_not_setis now a valid no-target signal alongsideprinter_not_set. Five new frontend cases inPipelineRunsPage.test.tsxpin the dashboard's empty state, list rendering, Cancel button on in-flight runs, Retry-failed button on partial-failure runs, and per-row expand to show jobs. Three updated frontend cases (RunWithPipelineModal.test.tsx) assert the new four-arg signature onrunPipeline(pipelineId, source, force, copies). One updatedSettingsPage.test.tsxsidebar-order test reflects the newpipelineRunsnav entry betweenqueueandprojects. Suites.pytest -n 30 backend/tests/6539/6539 green;npx vitest run2284/2284 green (173 files);npm run buildclean;python -m ruff check backend/clean;node scripts/check-i18n-parity.mjsclean. Scope. PR C closes the v3 design — no further pipeline PRs are queued. The existing print scheduler's model-based dispatch (PrintQueueItem.target_model+target_location+required_filament_types) is the only thing that makes class targeting actually distribute work; PR C just plugs into it. Thefill_one_firststrategy's "one printer fails, queue stalls" trade-off is documented in the editor's option-row hover-hint and in the orchestrator code comment — it's the correct behaviour for "I want one printer to finish a batch end-to-end" and the wrong behaviour for "I want resilience"; the right strategy for resilience ismax_parallel. Cross-printer-class pipelines (e.g. one pipeline targeting "any X1C OR P1S") remain out of scope — make two pipelines, one per class. - Slicer Pipelines — Archive entry point + progress toast for pipeline-driven slicing (#1425 PR B follow-up) — Two real gaps from the PR B drop. (1) The Run-with-pipeline button only existed in the file manager — operators who keep their working files in archives had to copy them out to the library to use a pipeline. (2) Triggering a slice via a pipeline produced a silent multi-second-to-minute wait — the manual SliceModal flow has the sticky
Slicing X — Generating G-code 75%persistent toast, the pipeline path went throughasyncio.create_taskdirectly and never registered withSliceJobTracker. Fix. (1)POST /slicer-pipelines/{id}/check-eligibilityandPOST /slicer-pipelines/{id}/runnow acceptsource_archive_idas an alternative tosource_library_file_id(XOR — Pydantic validator rejects both-set and neither-set), and the eligibility-check and orchestration paths branch via_resolve_sourcewhich readsarchive.source_3mf_pathwith a fallback toarchive.file_path.PipelineRun.source_archive_idis a new nullable FK column (Postgres + SQLiteALTER TABLEinrun_migrations— idempotent via_safe_execute).PipelineRunResponseechoes the field. ArchiveCard's context menu picks up aRun with pipelineitem alongside the existing Slice action (only on source archives — gcode archives already have Print + Open in BambuStudio), gated onuseSlicerApi+pipelines:run. Path-safety:Path(base_dir) / archive.source_3mf_pathcarries aSEC-PATH-OKmarker citing the upload-time validator at_resolve_source_3mf_path(same comment style asroutes/archives.py:3955); theLibraryFile.file_pathsite gets the same treatment. (2) The pipeline orchestrator is now theruncallable of aslice_dispatch.enqueuecall — the same dispatcher the manualSliceModalflow uses — instead of a bareasyncio.create_task. The SliceJob's lifecycle (pending → running → completed/failed) drives the existing progress toast end to end: same persistent toast, sameGenerating G-code 75%weave from the sidecar's--pipechannel, same auto-replace with a transient success/error toast on terminal.PipelineRun.slice_job_idis set on the run row before the route returns 202, so the frontend can calluseSliceJobTracker().trackJob(slice_job_id, source.kind, source.filename)fromRunWithPipelineModal'srunMutation.onSuccess— same one-call surface thatSliceModal's slice mutation already uses. (3)RunWithPipelineModal'ssourceprop is now{kind: 'libraryFile' | 'archive', id, filename}(mirrorsSliceModal.SliceSource);api.checkPipelineEligibility+api.runPipelinetake a discriminated-union source argument and route to the right backend field.PipelineRunTS type growssource_archive_id. Tests. Three new backend cases intest_pipeline_runs_api.py— archive-source happy path (creates a PrintArchive row + on-disk file, posts withsource_archive_id, verifies the response carriessource_archive_id+slice_job_idfrom a stubbedslice_dispatch.enqueue), XOR rejection both-set, XOR rejection neither-set. The existing three run/cancel cases were updated to patchbackend.app.services.slice_dispatch.slice_dispatch.enqueue(the new mock target) instead of the removed_run_pipeline_orchestrationhelper, and the run-happy-path now assertsslice_job_id == 9001arrives on the response. One new frontend case inRunWithPipelineModal.test.tsxpins the archive flow end to end (checkPipelineEligibilitycalled with{kind: 'archive', id: 7}, thenrunPipelinewith the same). The existing fast/slow path tests were updated to wrap inSliceJobTrackerProvider(the newuseSliceJobTrackerhook requires it) and to assert the new discriminated-union source argument. Suites.pytest -n 30 backend/tests/6533/6533 green;npx vitest run2279/2279 green (172 files);npm run buildclean;python -m ruff check backend/clean;node scripts/check-i18n-parity.mjsclean. Scope. No new i18n keys — both fixes reuse the existing PR B keys. No new permission. The archive flow only branches at the source-resolution layer; everything downstream (eligibility, slice, queue dispatch) is the same code path the library flow uses. PR C scope (multi-copy + class targeting + fanout) is unchanged. - Slicer Pipelines — Run a pipeline on a file with one click (#1425 PR B) — PR A landed the bundle (save & apply preset slots in the SliceModal). PR B turns that bundle into an actual one-click dispatcher: file-manager rows now carry a
Run with pipeline ▾button that slices the source through the pipeline's pinned printer/process/filament/bed-type combo and enqueues the print on the pipeline's pinned target printer. Scope. Single-target dispatch —target_kind='specific_printer'only. Multi-copy batch + class targeting + fanout strategies are PR C; the schema columns are already in place from PR A so PR C is code-only. Backend. Two new SQLAlchemy models —PipelineRun(one row per Run-pipeline click, carries the slice_job + sliced_library_file ids + snapshot status) andPipelineJob(one row per copy; PR B always 1, PR C variable). Soft-link to slicer_pipelines viaondelete='SET NULL'so run history survives a pipeline delete; same for source_library_file.statuson the run is a persisted snapshot that gets terminal transitions written (slice failure, cancel, completion); in-flight reads roll up the live state of the linked queue entry via_compute_run_status— that keeps the status accurate (pending → printing → completed) without a background watcher writing on every queue tick. Eligibility matcher atservices/pipeline_eligibility.py— given a pipeline + the livePrinterStatefromprinter_manager.get_status, returns a structured report with typed issues:printer_not_set,printer_not_found,printer_disabled(fromPrinter.is_activeshipped with #1476),printer_offline,filament_type_mismatch,filament_color_mismatch,ams_slot_missing,filament_unverified(cloud/standard tier presets can't be statically read here; surface as info, not a block). Canonical filament-type map mirrorsprint_scheduler._canonical_filament_typesoPLA Basic/PLA Matte/ etc. all collapse toPLAfor the type comparison; colour normalises to six-hex-digit lowercase. Eligibility is lenient with confirmation — the report drives the frontend confirmation modal, but the user canRun anyway(setseligibility_overridden=Trueon the run row so the audit trail shows which runs bypassed pre-flight). Routes. Two new routers —pipeline_run_create_routermounted under/slicer-pipelines(POST/{id}/check-eligibility, POST/{id}/run, GET/{id}/runs?limit=N) andpipeline_run_routerat/pipeline-runs(GET/{id}, POST/{id}/cancel).POST /runreturns 202 with the run shape; orchestration happens in a fire-and-forgetasyncio.create_taskthat opens its own DB session (the request's session is closed by the time it runs) and walks: status='slicing' →slice_and_persistwith the pipeline'sSliceRequest→ on successstatus='dispatching'+ insertPrintQueueItemwithprinter_id=target_printer_id, library_file_id=sliced_library_file_id. The existing scheduler picks the queue entry up on its next tick.POST /runwith eligibility issues and noforcereturns 409 with the report insidedetailso the frontend can render the same confirmation modal it would for an explicit pre-flight;force=truebypasses the 409 but a missingtarget_printer_idstill 400s (defence in depth — the UI can't enqueue the print without a target).POST /cancelis idempotent on terminal states and cascades to the linked queue entry when its status is stillpending/queued(in-flight prints continue — operator must Stop on the printer itself). SlicerPipeline.target_kind / target_printer_id become writable viaPUT /slicer-pipelines/{id}— the schema accepts both fields, the route treatstarget_printer_id=0as "clear" (the empty-<option>HTML coercion) and a positive value as a literal FK. Frontend. SlicerPipelinesPanel in Settings → Workflow → Pipelines extends its edit form with a target-printer<select>(populated fromapi.getPrinters()); pipelines without a target render an amber "Set a target printer to run this" hint in the row + a "Set a target printer before running this pipeline" warning at the bottom. Last-run summary appears inline per row — smallLast run: completed · 27/06/2026, 14:23line driven byGET /slicer-pipelines/{id}/runs?limit=1with a 15 srefetchIntervalso the chip ticks while a run is in flight.RunStatusBadgecolour-codes the seven states. New componentRunWithPipelineModalatcomponents/RunWithPipelineModal.tsx— two-step dialog: step 1 lists the user's pipelines (each row shows the pinned target printer; pipelines without a target are disabled with aNo target printer sethint), step 2 is the eligibility confirmation. Fast path: ok=true skips step 2 entirely and fires the run straight from the pipeline pick. Slow path: shows per-issue text via theIssueTextmapper — eg.Filament slot 1: expected PLA, AMS has PETGforfilament_type_mismatch,AMS slot 2 not available on this printerforams_slot_missing— thenRun anywayposts withforce=true. FileManagerPage integration: FileCard's action menu picks up aRun with pipelineentry (gated on the newpipelines:runpermission); list-view rows get a matching inline Play-icon button so list users have the same entry point as card users. Both flow into the samesetRunPipelineFile(file)state which renders the modal. The action is only offered on slice-eligible files (3MF / STL / STEP) and only whenuse_slicer_apiis on — matches the existing Slice button gating, since a non-slice-eligible file can't reach the slice step in any case. Frontend types: client.ts growsPipelineEligibilityReport,PipelineRun,PipelineJob,PipelineRunListResponse, plus six newapi.*methods (checkPipelineEligibility,runPipeline,listPipelineRuns,getPipelineRun,cancelPipelineRun, and the updatedupdateSlicerPipelinewhich now acceptstarget_kind+target_printer_id). ThePermissionunion also getspipelines:read | pipelines:write | pipelines:run— these were on the backend Permission enum from PR A but had been missed in the frontend union (caught when TS rejectedhasPermission('pipelines:run')). i18n. ~36 new keys acrosslibrary.runWithPipeline.*(modal title / confirm / source-hint / pipeline-hint / target-hint / Run-anyway / 8 issue-kind strings / 2 toast / empty-state / no-target hint) andsettings.pipelines.field.targetPrinter/field.noTarget/noTargetHint/noTargetWarning/runs.lastRun+ sevenruns.status.*strings — translated in all 11 locales (de / en / es / fr / it / ja / ko / pt-BR / tr / zh-CN / zh-TW). Parity check 5473 leaves per locale, no English fallback. The stringslicingwas added toIT_COGNATES(genuine cognate — same word in Italian). Tests. 13 new backend integration cases intest_pipeline_runs_api.pycovering PUT target write + clear-via-0 + check-eligibility (printer_not_set / printer_disabled cascade with offline / fully-clear AMS-match) + run flow (409 on issues+!force / 400 on force+!target / 202 on clean path with creation of run+job) + list/get 404s + cancel (404 / marks queued / idempotent on terminal). Slicing itself is stubbed viapatch(..._run_pipeline_orchestration)so CI runs without a live sidecar. 4 new vitest cases inRunWithPipelineModal.test.tsxpin the modal's two-step flow: empty state, disabled pipeline-without-target, fast-path (issues empty → modal closes immediately afterrunPipeline(..., false)), slow-path (issues shown →Run anywayposts withforce=true). Suites.pytest -n 30 backend/tests/6530/6530 green;npx vitest run2278/2278 green (172 files);npm run buildclean;python -m ruff check backend/clean;node scripts/check-i18n-parity.mjsclean. What's out of scope for PR B. Multi-copy (copies > 1), class targeting (target_kind='printer_class'), fanout strategies, the Pipeline Runs dashboard — all PR C. Painted multi-filament 3MFs still hit the upstream OrcaSlicer CLI gate (OrcaSlicer/OrcaSlicer#13774); the slice step inside the pipeline run fails the same way the standalone slice route does, the run rolls up tostatus='failed'with the slicer's error string inerror_message. The print queue's existing AMS / filament check + the printer-side error path remain authoritative for what actually happens at the machine — pipeline eligibility is a pre-flight, not a hard guard. - Slicer Pipelines — save & reuse a preset bundle in one click (#1425 PR A, requested by TheUltimateC0der) — Top feature in the first sponsor vote. The SliceModal forces the user to pick four slots every time: printer / process / filament(s) / bed type. For fleet production that's tedious and error-prone — operators want a named "Production PLA" bundle they can apply with one click on every file and every printer. PR A scope. Definitions only. The new model
slicer_pipelinesmaterialises the bundle plus future-PR columns (target_kind,target_printer_id,target_model_class,fanout_strategy) so PR B (single-target dispatch) and PR C (multi-copy batch with capability-matched fanout) are code-only, not migrations. The bundle is independently useful in PR A as an ergonomic improvement: pipelines are picked from the SliceModal, applied to the four slots, then sliced through the existing flow. No new dispatch behaviour yet. Backend. ModelSlicerPipeline(models/slicer_pipeline.py), Pydantic schemasSlicerPipelineCreate/Update/Responsereusing the existingPresetRefshape fromschemas/slicer.py, CRUD routes at/api/v1/slicer-pipelines/(GET list,POST create,GET/PUT/DELETE by id). Soft-delete viais_deletedso PR B+ run history can still resolve pipeline metadata after the operator removes one. Listed newest-first byid DESC(more reliable thancreated_atunder back-to-back inserts whose DateTime precision can tie). Routes use explicitawait db.commit()after the mutation (matches theroutes/library.pypattern) so the response shape returns the committed row. Permissions. Three newPermissionvalues:PIPELINES_READ,PIPELINES_WRITE,PIPELINES_RUN. PR A only consumes the first two;RUNis defined now so PR C doesn't need to backfill.AdministratorsandOperatorsget all three;ViewersgetPIPELINES_READ. A backfill block inseed_default_groups()adds them to existing groups on upgrade (mirrors thelibrary:purge/archives:purgepattern from earlier). All three are added to_APIKEY_DENIED_PERMISSIONSso they fail closed for any API-key surface — PR B / PR C may movePIPELINES_RUNontocan_queueonce the dispatch lands. Frontend. Settings → Workflow tab is split into two sub-tabs mirroring the Authentication tab's pattern: Queue & Dispatch (the existing Workflow content) and Pipelines (the new manager). The Workflow sidebar entry stays single — no expandable submenu — and the sub-tab choice is reflected in the URL (?tab=queue&sub=pipelines) for deep-linking. SlicerPipelinesPanel lists saved pipelines with inline rename, soft-delete, and a stale-preset warning when a referenced preset no longer resolves against the unified-presets listing (e.g. anorca_cloudpreset deleted in OrcaSlicer; the pipeline still saves, the warning prompts a re-save from the SliceModal). Full pipeline creation lives in the SliceModal rather than Settings — the user has already done the four-slot work there. The modal grows anApply pipeline ▾dropdown plus aSave as pipelinebutton above the existing preset dropdowns. Apply fills all four slot states (printerPreset,processPreset,bedType,filamentPresets[]); the filament list right-pads from current state so a pipeline with fewer entries than the current source's slot count keeps the existing tail (lets the same pipeline apply across single-color and multi-color files). Save captures the four-slot picks under an inline-named pipeline. Stale-preset warning shows on the Settings list, not blocking apply, so an old pipeline with a one-deleted-preset can still be re-applied and re-saved with the new pick. i18n. ~30 new keys acrosssettings.pipelines.*andslice.pipelines.*plussettings.tabs.queueDispatch/queuePipelines, translated in all 11 locales (de / en / es / fr / it / ja / ko / pt-BR / tr / zh-CN / zh-TW). Parity check 5437 leaves per locale, no English fallback.Pipeline/Pipelines/Filament {{n}}added toIDENTICAL_TO_EN_ALLOWEDfor the locales where they're genuine cognates (de / es / fr / it / pt-BR / tr). Tests. Backend: 11 integration cases intest_slicer_pipelines_api.pycovering empty list, create + round-trip, get-by-id, partial PUT preserves untouched fields, filament list replaces wholesale, soft-delete hides from list + GET-by-id, 404s on missing, schema rejection of empty filament list + invalid PresetRef source, newest-first ordering. Frontend: 3 new SliceModal cases (apply-pipeline dropdown disabled-empty / apply-sets-state / save-as-pipeline-round-trip) plus 2 SettingsPage cases (sub-tab nav renders + Pipelines deep-link). Existing SliceModal tests adjusted via apresetSelects()helper that filters out the new Apply-pipeline combobox so historicalselects[0]indexing into printer/process/filament remains stable. Suites.pytest -n 30 backend/tests/6517/6517 green;npx vitest run2274/2274 green (171 files);npm run buildclean;python -m ruff check backend/clean;node scripts/check-i18n-parity.mjsclean. Scope. No new dispatch behaviour yet — pipelines are a preset-bundle convenience layer in PR A. PR B adds single-target dispatch (thetarget_kind='specific_printer'path), PR C adds multi-copy batch with capability matching + the three fanout strategies (max_parallel/fill_one_first/round_robin). TheRun pipelineaction mentioned in the original issue is PR B/C and intentionally not exposed in this drop. Painted multi-filament 3MFs still hit the upstream OrcaSlicer CLI gate (OrcaSlicer/OrcaSlicer#13774); the slice fails, the pipeline doesn't pre-validate. - Sticky upload-progress toast restored for scheduler-driven dispatch (#1625 follow-up) —
#1625(Unify print dispatch through the scheduler) moved every print's FTP push to the printer into the server-side scheduler tick, which means the user's click no longer carries an XHR withprogressevents — the old browser-side upload modal had nothing to show because there was no browser-side upload anymore. Users only saw the queue item flip to "active" with no visibility into the multi-second to multi-minute FTP push + the H2D/H2D Pro 80–210 sproject_filedigestion window before the printer actually started extruding. Fix. The legacy bg-dispatch toast rendering from0b43ac0d:frontend/src/contexts/ToastContext.tsxlines 510–650 is ported back in place verbatim — same DOM tree, same Tailwind classes, sameformatFileSizebytes line, same uppercase status chip, same collapse chevron, sameawaitingPrinterderivation, same auto-dismiss-when-all-terminal — only adapted to read from the four scheduler-side WS events introduced here instead of the legacybackground-dispatchaggregate event. Materialization only on actual upload start. The toast appears when the FTP push to the printer starts (queue_item_uploading), NOT onPOST /queue— a draft that emitted at queue-add time made the toast jump to "Dispatched" before any upload had happened. Four backend lifecycle WS events drive the rendering:queue_item_uploading(start of FTP, carriesprinter_name+total_bytesfromfile_path.stat().st_size),queue_item_upload_progress(throttled byte-level updates — first call always emits + emit when ≥200 ms elapsed OR ≥256 KB transferred since last emit, plus always emit atbytes_transferred >= total_bytes; this matches the legacybackground_dispatch.py:614-615gates 1:1 so the bar feels identical on small AND large files; a single shared_UploadProgressBridgeinstance bridges from the FTP executor thread back to the asyncio loop viarun_coroutine_threadsafe),queue_item_acked(watchdog confirmed printer transitioned out ofpre_state),queue_item_failed(any error, with areasonkey the toast looks up asdispatchToast.failed.{reason}for upload-vs-start-command differentiation, generic fallback). Noqueue_item_dispatchedevent — the legacy bg-dispatch path keptstatus='processing'from upload start until printer ack, and the "Awaiting printer…" subtitle is derived purely fromupload_progress_pct >= 99.9(the legacyuploadDoneAwaitingPrintertrick at line 568-572). An explicitdispatchedevent would push the status chip out ofPROCESSINGprematurely — which is exactly what the first screenshot-iteration showed. Per-user routing. Newws_manager.broadcast_to_user(user_id, msg)filters connections bywebsocket.state.bambuddy_principal_user_id— resolved once at WS connect time via aselect(User.id).where(User.username == principal)lookup so per-message routing is O(connections) not O(connections × DB). Auth-disabled installs routeuser_id=Noneto all connections, matching the legacy single-user toast behaviour. The watchdog success path receivescreated_by_idvia a new kwarg so the static_watchdog_print_startmethod can still emit theackedevent without re-fetching the queue item. Backend. ~110 LOC across 3 files:core/websocket.py(broadcast_to_user+ four event helpers,bambuddy_principal_user_idfilter on each connection),api/routes/websocket.py(principal username → User.id resolve at connect, stashed onwebsocket.state.bambuddy_principal_user_id),services/print_scheduler.py(_UploadProgressBridgethread-safe throttle class,queue_item_uploadingemitted before FTP withprinter.name,progress_callback=plumbed into both thewith_ftp_retryand directupload_file_asyncbranches via**kwargs,queue_item_failedat the FTP-fail spot, watchdog success path emitsackedon both Phase A and Phase B exits). Frontend. Rendering ported in place tocontexts/ToastContext.tsx(dispatchDatafield onToast, ingestuseEffectmapping the fourbambuddy:dispatch-toastevent types to legacyDispatchToastJobshape, terminal-state auto-dismissuseEffect; legacy rendering block reused 1:1 minus the cancel button — BG dispatch's/background-dispatch/{id}DELETE doesn't exist in the scheduler model and adding it is out of scope).hooks/useWebSocket.tsforwards the fourqueue_item_*cases viawindow.dispatchEvent(new CustomEvent('bambuddy:dispatch-toast', { detail })), matching the existingplate-not-empty/unknown-tagpatterns. i18n. 11 keys × 11 locales underdispatchToast(de / en / es / fr / it / ja / ko / pt-BR / tr / zh-CN / zh-TW):untitled/startingPrints/progressSummary(header{{complete}}/{{total}} complete • Processing: {{processing}}—Dispatched: Xfrom the legacy summary was dropped because the scheduler has no pre-upload "dispatched" state) /expandDetails/collapseDetails/awaitingPrinter/status.{processing|completed|failed}/failed.{generic|upload_failed|start_command_failed}/dismiss. Locale parity check 5401 leaves per locale, no English fallback. Tests. Backendtest_ws_broadcast_to_user.pypins the routing contract (filter by user_id, fan-out on None, payload shape withprinter_nameforuploading, server-side pct compute including divide-by-zero);test_upload_progress_bridge.pypins the throttle (first call always emits, 256 KB byte gate honoured even when time gate would skip, completion always emits, no-op on zero bytes, no-op when no loop). Frontend__tests__/contexts/DispatchToastContext.test.tsxpins the materialization-on-uploading invariant (stray progress / acked event before anyuploadingdoes NOT render — regression guard), the uploading → "Awaiting printer…" → acked lifecycle with status chip stayingPROCESSINGthrough the whole upload (regression guard for the screenshot-reported "Dispatched: 1 immediately" bug), 3.5 s auto-dismiss when terminal, concurrent jobs sharing one wrapper, collapse + dismiss buttons. Suites.pytest -n 30 backend/tests/unit/test_ws_broadcast_to_user.py backend/tests/unit/test_upload_progress_bridge.py backend/tests/integration/test_print_queue_api.pygreen;vitest run src/__tests__/contexts/49/49 green;ruff check backend/clean;npm run buildclean. Scope. No DB migration. No new permission. Thebambuddy:dispatch-toastwindow event is internal to the frontend bundle, not a public hook — third-party plugins should not subscribe to it. The 0–30 s scheduler-tick pickup wait is unchanged; this fix only addresses visibility of what happens once the upload starts. Tiny test files that upload in a single FTP chunk will still jump straight to "Awaiting printer…" because the first-and-last progress callback is one and the same event — same edge as the legacy bg-dispatch behaviour on sub-256 KB files. - Cam Wall: don't kill shared streams when one viewer closes + offline tiles show OFF, not LIVE — Two small but load-bearing fixes against the new cam-wall view. (1) Offline tile chip. A disconnected printer (
status.connected === false) was still assignedlivemode byCameraWall.modeByPrinter— it consumed aMax live streamsbudget slot AND rendered the redLIVEchip on top of theWifiOffplaceholder. The allocator now treats!connectedlike off-screen — assignspaused, leaves the live budget intact. The existingCameraTilerendering (WifiOfficon, darkOffchip) takes over automatically. Side effect: an 8-printer wall with 2 offline X1Cs no longer wastes 2 of the 4 default live slots on dead tiles. (2) Shared-broadcaster teardown./api/v1/printers/{id}/camera/stopis the unmount cleanup for every camera consumer (CameraTile,EmbeddedCameraViewer, popupCameraPage). It used to unconditionallyshutdown_broadcaster(f"printer-{id}")+ kill every ffmpeg in_active_streamswhose key starts with{printer_id}-. The fan-out broadcaster is shared across all viewers of the same printer, so closing the embedded viewer while the cam-wall tile of the same printer was visible force-killed the source the tile was pulling from — the tile's<img>errored out and showedNo signaluntil the user navigated away. The broadcaster itself already has correct natural-shutdown semantics: each subscriber's HTTP teardown callsunsubscribe(queue), and when the count reaches 0 the broadcaster's own_grace_then_stopwaits_GRACE_SECONDS(5 s) before tearing down — re-checking under the lock so a new subscriber rejoining cancels the shutdown./camera/stopwas just a fast-cleanup shortcut for the single-viewer case. Fix. Newget_subscriber_count(key)accessor incamera_fanout.pyexposes the broadcaster'ssubscriber_count(the private list-len already used internally). The/camera/stoproute now readsget_subscriber_count(f"printer-{printer_id}")BEFORE the force-teardown; when ≥ 1 subscriber is still attached, it returns{"stopped": 0, "skipped": true}early and leaves the broadcaster + ffmpeg processes alone. The leaving viewer's HTTP teardown still runs the naturaliter_subscriber.finally → unsubscribepath, so its subscription is correctly released; the broadcaster keeps serving the other viewer(s). Single-viewer close still hits the force-teardown path immediately (no subscribers remain at all). Cost: in the race where the leaving viewer's HTTP teardown has already propagated to the broadcaster at the moment its/camera/stopPOST lands (count just dropped to 0), force-teardown still runs and we miss the optimization for a different actually-still-subscribed viewer — but the natural grace-shutdown bounds the worst case at 5 s of ffmpeg tail, not a stuck stream. Verified by inspection: this race only matters when subscriber_count transitions through 0 between the HTTP teardown and the POST, which requires both viewers' tabs to close in lockstep — practically unobservable. Tests. Newtest_stop_camera_stream_skips_shutdown_when_subscribers_remainintest_camera_api.pypatchesget_subscriber_countto return 2 and asserts/camera/stopreturns{stopped: 0, skipped: true}, does NOT callshutdown_broadcaster, and does NOT terminate any_active_streamsffmpeg process. The existing 6 stop-route tests stay green because they don't pre-populate subscribers —get_subscriber_countreturns 0, the early-return doesn't trigger, and the existing force-teardown still runs. Fulltest_camera_api.py43/43 green.ruff check backend/clean. Frontendnpm run buildclean. Scope. No API contract change — the existing{"stopped": int}shape is preserved, the new"skipped"field is additive. No new permission. No DB migration. No i18n change. - Cam Wall: per-tile print/printer status overlay — Cam-wall tiles now surface live printer state on top of the camera image instead of being a pure video grid. A new gear-menu toggle
Status overlayswitches betweenOff,Compact, andFull(defaultFull). Compact paints a colour-coded state chip in the top-left corner —Printing/Paused/Finished/Error— bucketed using the sameclassifyPrinterStatusrules that drive the printer-card badges, withIdledeliberately suppressed so a wall of cold printers stays visually quiet. Full adds a bottom info strip on tiles whose state isPrintingorPaused: the active file'ssubtask_name ?? gcode_file, the rounded progress percent,Layer N/Mwhen both are known, and the remaining time formatted by the existingformatDuration(remaining_time * 60)helper fromutils/date.ts— so the numbers match what the printer card shows for the same printer. When the printer's known HMS errors are non-empty (filtered via the existingfilterKnownHMSErrorsfromHMSErrorModal), the chip flips to the redErrorcolour with alucide-reactAlertTriangleicon inline. The whole overlay layer is gated byconnected— disconnected and paused-mode tiles render the existing offline / paused placeholders unchanged. Zero new network cost.CameraWall.tsxalready ranuseQueries({ queryKey: ['printerStatus', id], ... })against every printer for the connected flag; the patch widens theuseMemoto expose the fullPrinterStatuspayload and threadsstate,progress,remaining_time,layer_num,total_layers,subtask_name,gcode_file, and the filtered HMS error count into eachCameraTile— same shared React Query cache thePrinterCardflow populates, so Cards ↔ Cam Wall flips remain instant and the wall opens no second status fan-out. Settings. Per-user, persisted inlocalStorageundercamWallStatusModealongside the existingcamWallMaxLiveandcamWallSnapshotSeckeys. The picker is a three-segment button row inside the existing cam-wall settings popover (gear icon, click-outside dismiss), labelledOff/Compact/Full. DefaultFullbecause the cards already show this info — users who pick cam-wall view still want to glance the same details without flipping back. CameraTile contract. All new props (statusMode,printerState,progress,remainingMin,layerNum,totalLayers,printName,hmsErrorCount) are optional with safe defaults, so the 5 existing vitest cases inCameraTile.test.tsxcontinue to pass unmodified — the status layer is purely additive on the leaf component. The state-bucket classifier lives co-located inCameraTile.tsx(mirrorsPrintersPage.classifyPrinterStatusforRUNNING/PAUSE/FINISH/FAILED) so the tile renders correctly even if called outside the cam-wall scheduler. Temperatures intentionally not surfaced. Nozzle / bed / chamber readouts would crowd the tile and overlap the existing top-right LIVE/SNAP/OFF mode indicator and bottom-edge printer name; the printer card remains the canonical surface for those. i18n. 7 new keys underprinters.camWall(layer,timeLeft,statusMode.{off,compact,full},settings.statusOverlay,settings.statusOverlayHint) translated in all 11 locales (de / en / es / fr / it / ja / ko / pt-BR / tr / zh-CN / zh-TW) — no English fallback. State chip labels reuse the existingprinters.status.{printing,paused,finished,error,idle}keys so no new translation work was needed for the bucket vocabulary. Parity scriptcheck-i18n-parity.mjsadds two legitimate-cognate exceptions:Compactfor French (same word) andOfffor Italian (universal loanword); both remain real translations in every other locale. Parity check 5388 leaves per locale. Scope. No backend change. No new request. No new permission. No DB migration. The toggle defaults toFull, so installs see the overlay the first time they open Cam Wall — flipping toOffreverts to the original camera-only behaviour. - Cam Wall view on the Printers page — New view toggle next to the card-size selector flips the entire printers list into a responsive grid of live camera tiles (
Cards↔Cam wall). Reuses the existing per-printer FTP / RTSPS proxy on/api/v1/printers/{id}/camera/stream, so the backend ffmpeg fan-out is the same one EmbeddedCameraViewer already drives — no new server-side state machine. Bandwidth ceiling matters on the RPi installs ([[bambuddy-install-base-2026-06-20]] documents that the median deployment is a Pi 4): each live tile is one TLS pull + one MJPEG fan-out. To stay sustainable on a Pi 4 with 8+ printers, only the tiles currently on-screen are live, and only up toMax live streams(default 4) at any moment — everything else falls back to per-tile snapshot polling against/api/v1/printers/{id}/camera/snapshotat a configurable interval (default 8 s). Tiles that scroll off-screen pause entirely. Architecture.frontend/src/components/CameraTile.tsxis the leaf — three modes (live/snapshot/paused), a single<img>element withloading="lazy", anonErrorno-signal fallback, and auseEffectcleanup that POSTs/camera/stop(withkeepalive: true) on mode-out-of-live AND on unmount so the backend releases the transcoder slot. Same/camera/stopdiscipline EmbeddedCameraViewer uses, so a tile that scrolls off the wall is byte-identical to closing a floating viewer.frontend/src/components/CameraWall.tsxis the scheduler — anIntersectionObserver(threshold 0.4 to avoid flicker at scroll boundaries) tracks visibility, then auseMemowalks the printer list in sort order and assigns the first N visible tiles tolive, the rest of the visible set tosnapshot, and off-screen tiles topaused. The walker is stable on a given render (no LRU eviction churn) which avoids the "tile flickers between live and snapshot every frame" failure mode. Reuses the same['printerStatus', id]React Query cache eachPrinterCardalready populates, so flipping between Cards and Cam Wall is instant and the wall doesn't open a second status fetch fan-out. Clicking a tile honours the existingSettings → camera_view_modepreference — opens the floatingEmbeddedCameraViewerwhen set toembedded, otherwise pops the/camera/:idwindow with the saved size/position fromcameraWindowState. Settings. Both knobs are per-user, persisted inlocalStorage(camWallMaxLive,camWallSnapshotSec) — not a global backend setting, since a Pi 4 user and a NUC user looking at the same install want different caps. Bounded[1, 16]for max live and[2, 60]seconds for snapshot interval, both rendered as an inline gear-icon popover above the grid with click-outside dismiss. The Cam Wall button is permission-gated oncamera:view; viewers without the permission see it disabled. The card-size selector goes opacity-40 + pointer-events-none in cam-wall mode (tile size is governed by the responsive grid, not the cardSize knob). i18n. 13 new keys (printers.pageView.cards,printers.pageView.camWall,printers.camWall.{noPrinters,noSignal,live,snap,off,summary},printers.camWall.settings.{title,maxLive,maxLiveHint,snapshotInterval,snapshotIntervalHint}) translated in all 11 locales (de / en / es / fr / it / ja / ko / pt-BR / tr / zh-CN / zh-TW) — no English fallback. Parity check 5369 leaves per locale. Tests. 5 new vitest cases infrontend/src/__tests__/components/CameraTile.test.tsxcover live URL emission withfps=8, snapshot URL emission with the cache-bust counter advancing on the interval, offline placeholder for disconnected printers, paused placeholder rendering, and the/camera/stopPOST firing when the tile transitions out of live. Scope. No backend change. No DB migration. No new permission. The existingEmbeddedCameraVieweris untouched — Cam Wall is purely additive. TheprinterPageViewtoggle defaults tocards, so installs see no behaviour change until a user picks Cam Wall. - AMS drying badge now shows the active cycle's filament + target temperature — During an active drying cycle the AMS card on the printers page renders
Drying · PETG 65°C · 11h 35m left(the loaded-filament line under the slots) instead of the bareDrying · 11h 35m left. Bambu's per-tick AMS push only carries thedry_timecountdown — the chosen filament name and target temperature are never echoed on the wire, so the badge had no source of truth for them.BambuMQTTClient.send_drying_command(mode=1, ...)now caches{ams_id: {filament, temp}}on the client; the cache is cleared onmode=0and on the per-AMSdry_timefalling-edge to 0 (same detector that drives the smart-plug-after-drying callback).PrinterManager.get_drying_targets(printer_id)exposes it,printer_state_to_dictandroutes/printers.py::get_printer_statusthread it onto each AMS dict asdry_target_temp+dry_filament, the AMS schema gains both fields, and the AMS-HT compact badge gets the same render. Falls back to the first loaded tray'stray_type+ RFID-recommendeddrying_tempwhen no cached target (drying started before backend launch, backend restarted mid-cycle, or cycle started from another source) — the same heuristic the popover already uses to seed defaults. New i18n keyprinters.drying.targetSummary={{filament}} {{temp}}°C, translated in all 11 locales (parity check 5356 leaves per locale). 5 new backend tests inTestSupportsDryingCommand(cache populated on mode=1, overwrite on second start, cleared on mode=0, per-AMS isolation across stop) and 4 new tests inTestDryingTargetExposure(cached target wins over fallback, fallback derives from loaded tray, both fields None when no cache + empty trays, targets don't leak across AMS ids). Note about Bambu's printer display. A user reported that with PLA loaded in AMS-A slot 1 and a Bambuddy-initiated PETG 65°C drying cycle, the H2D's own screen showed "PLA" — Bambuddy's wire payload was confirmed correct via journalctl (filament: "PETG"sent,result: success, filament: PETG, temp: 65ACKed back). The display behaviour is the Bambu firmware labelling the active cycle by the loaded tray's filament rather than thefilamentfield of the command. This Bambuddy change makes our own UI reflect what we actually sent, independent of the firmware's display choice. - Continue auto-drying while a print is running on capable hardware — Bambu shipped "Print While Drying" firmware-side on H2D (01.03.00.00+), H2C / H2S / P2S / H2D Pro (01.02.00.00+), X2D / A2L (01.01.00.00+), and X1C (01.11.02.00+). The existing Queue Auto-Drying loop only fires on idle printers — when a print starts, drying stops or never starts, even though the spools may still be wet. New Settings → Print Queue → "Continue drying while printing" toggle (default OFF) lets the same scheduler evaluator also run on the busy printer set. Backend:
supports_drying_while_printing(model, firmware)inprinter_manager.pyis a strict allowlist verified against Bambu's wiki release-notes phrasing ("printing while filament is drying" / "Print While Drying" — every matrix-confirmed model carries that wording verbatim; P1P / P1S / A1 / A1 Mini / X1 (non-C) / X1E are intentionally excluded because the wiki is silent for them, and on those models the firmware would reject the command anyway viadry_sf_reason=[0](TaskOccupied)). The capability is gated on both display names ("H2D","X1C", ...) and internal SSDP / MQTT model codes ("O1D","O1E","O2D","O1C","O1C2","O1S","N6","BL-P001","N7","N9") — the printer'smodelfield can carry either, the existingsupports_dryingprecedent uses both._check_auto_dryinginprint_scheduler.pynow resolves model + firmware up front for every printer and computesmid_print = busy AND toggle_on AND supports_drying_while_printing; whenmid_printis True the busy-skip, queue-only-skip, and idle-skip gates are bypassed and the existing humidity /dry_sf_reason/ drying-presets / mode-1 send path takes over. Safety: drying temp is capped atmax(40, preset_temp - 5)for mid-print drying — Bambu's own release notes for H2D and P2S spell out "Lower drying temperature during printing" / "The drying temperature must not exceed the filament's softening temperature", so a 5 degC offset from the idle preset (floor 40) protects spools inside a hot enclosure during an active print. The early-return guard that short-circuits the evaluator when "only queue mode is on AND nothing scheduled" was also extended to skip the short-circuit whenprint_drying_enabledis on — otherwise busy printers would never be reached. The manual drying button on the AMS card needs no UI change:routes/printers.py::start_dryinghas no Bambuddy-sideis_idlegate; the "printer busy" rejection comes from firmwaredry_sf_reason=[0], which simply won't appear on supported firmware mid-print. The new capability flag is also surfaced onPrinterStatus.supports_drying_while_printingso the frontend can light up the AMS card affordances correctly. Settings. Newprint_drying_enabled: bool = Falseinschemas/settings.py, added to the boolean allowlist inroutes/settings.py(_BOOL_KEYS), and threaded through the existing dirty-detection / save call inSettingsPage.tsx. i18n. 2 new keys (settings.printDryingEnabled,settings.printDryingEnabledDescription) translated in all 11 locales (de / en / es / fr / it / ja / ko / pt-BR / tr / zh-CN / zh-TW). Parity check 5354 leaves per locale, no English fallback. Tests. 7 new cases inTestSupportsDryingWhilePrintingcover every supported display name + internal code, below-min firmware, excluded models (P1*,A1,A1 MINI,X1,X1E), missing firmware,Nonemodel, case-insensitivity, and the strict unknown-model default (False — unlikesupports_dryingwhich leniently allows unknowns). 4 new scheduler integration cases inTestMidPrintDryingcover: toggle ON + capable hardware fires drying at the 40 degC cap for PLA, PETG caps to 60, toggle OFF still skips busy printers, and toggle ON with too-old firmware / excluded model still skips. Fullpytest -n 30green (4251/4251 in 49 s). Backendruffclean. Frontendnpm run buildclean. Scope. No DB migration. No new permission. The new toggle is opt-in (default OFF) — existing installs see no behaviour change until a user enables it, and the firmware is the ultimate arbiter viadry_sf_reasonso being too permissive here costs nothing. - Batch / mass edit on the Filament tab (#1795, requested by RoBoT24-web) — Bulk operations land on the Inventory page in both built-in and Spoolman modes. Reporter wanted "ten of the same spool, set a pressure advance value, save once" — the existing flow forced ten round-trips through the per-spool editor. Frontend. A new checkbox column anchors the leftmost slot of every row in the table view (header checkbox toggles every visible row; group rows expose a single checkbox that selects every member). As soon as one row is selected, a sticky toolbar appears above the list with Edit / Print labels / Reset usage / Archive (or Restore in the Archived tab) / Delete / Clear selection. The selection clears automatically on any filter or tab change so the toolbar count can never drift from what's on screen. A new
BulkEditSpoolsModalis the entry point for the bulk-edit action: a three-state-per-field form (untouched / set-to-value) over the flat spool attributes — material, subtype, brand, color name + RGBA, storage location, slicer filament name + ID, cost / kg, note, label weight, core weight, category, low-stock threshold %. The reporter's pressure-advance use case (K-profile) stays per-spool because K-profiles are scoped per(printer, extruder, nozzle_diameter)and bulk-applying a single K-value across heterogeneous printers would create wrong calibration — they're handled in the existing per-spool K-profile editor instead. Clearing fields in bulk is intentionally NOT supported (user decision on #1795): bulk-set lets you only WRITE non-empty values; emptying ten notes by mistake is a one-click disaster the dialog doesn't expose. The per-spool editor remains the path for clearing. Same dropdown controls the per-spool editor uses. Material, sub-type, brand, category, slicer preset name, and slicer filament are all rendered through a newSearchableSelectcomponent matching the per-spool form's pattern (text input + chevron + filtered list of buttons, click-outside + Escape close). No native<select>anywhere in the modal. Material / sub-type / brand options merge the canonicalMATERIALS/KNOWN_VARIANTS/DEFAULT_BRANDSconstants fromspool-form/constants.tswith whatever's already in inventory. Slicer-preset dropdowns fetch the same sources as the per-spool form (Bambu Cloud presets when signed in, Orca Cloud profiles, local presets, built-in filaments) via threeuseQuerycalls gated onisOpenso closed modal pays no fetch cost; results pipe through the sharedbuildFilamentOptions(...)helper so the option list is byte-identical to what the per-spool editor shows. Storage location is asearchableClosedSearchableSelect over actualapi.getLocations()rows mapped tolocation_id(the FK), matching the per-spool form's behaviour (rather than the legacy free-textstorage_locationcolumn, which would have written to a different column than the per-spool editor). Backend. Four new endpoints per inventory mode, eight total:POST /api/v1/inventory/spools/bulk-update,bulk-delete,bulk-archive,bulk-restore(built-in) and the matching/api/v1/spoolman/inventory/spools/bulk-*(Spoolman). All gated on the existingINVENTORY_UPDATE/FILAMENTS_UPDATEpermissions used by the per-spool routes. The built-in update endpoint runs the sameprepare_internal_spool_payload(...)path as the per-spool PATCH (location resolution, weight-lock auto-stamp on explicitweight_used— both inherited identically). The Spoolman update endpoint loops the existing per-spoolupdate_spoolroute function so the complex filament re-linking / extra-dict / extra-lock / shared-filament-detection rules stay byte-identical to single-spool edits — the bulk route is just a fan-out, not a parallel reimplementation. Per-spool failures inside the loop are collected and returned as{updated, errors: [{id, status, detail}]}so one bad ID never aborts the batch. The built-in archive endpoint reports{archived, already_archived, not_found}so the UI can distinguish "no-op because already archived" from "missing row." Both modes broadcast a singleinventory_changedWS event at the end of the batch instead of one per row, so the table refresh is a single re-fetch. Spoolman bulk-delete / archive / restore now also catch non-HTTPException mid-batch — earlier these three caught onlyHTTPException; a mid-batchhttpx.ConnectError/TimeoutError/KeyErroraborted the route with a 500, the loop's accumulated state was lost, and theinventory_changedbroadcast was skipped so the table didn't refresh past the partial state.bulk_update_spoolsgot this right out the gate; the audit pass added the sameexcept Exceptionarm to the other three so a transient Spoolman blip surfaces in the per-row errors array instead of obliterating the whole batch. All-failed and partial-failure are surfaced to the user. The first cut of the fouronSuccessmutation handlers only read the success count, so a response of{updated: 0, errors: [50 entries]}(e.g. every selected ID was deleted by another user before the click landed) showed a green "0 spools updated" toast and silently cleared the selection. The handlers now branch on three outcomes — all-succeeded (existing success toast), partial ({ok, failed}warning toast), and all-failed (red error toast + selection preserved + modal stays open so the user can retry). Same shape for delete / archive / restore.bulkResetConsumedCounterMutation.onSuccessnow closes the confirm modal + clears the selection — earlier inconsistency with the other three bulk mutations left the confirm dialog open after the action. Invalid RGBA hex is now flagged inline instead of being silently dropped from the patch. Typing "RED" or "FF00" in the colour field now paints the input red with helper text and disables the Apply button via a newhasDroppedTickedFieldguard that detects any ticked field whose value gets normalised away — without this guard the user clicked Apply, the rgba was silently omitted, and the success toast still fired for the other fields. Backend tests. 17 new integration cases. 10 intest_inventory_bulk.pycovering update applying to multiple rows, unknown IDs reported innot_found, empty update body rejected with 400, weight-lock auto-stamp parity with per-spool PATCH, emptyidsrejected with 422, bulk delete with mixed valid/invalid IDs, archive settingarchived_aton multiple rows + skipping already-archived, restore the symmetric inverse. 7 intest_spoolman_inventory_bulk.pycovering the Spoolman update callingupdate_spool_fullonce per ID with the same payload, per-spool exception collected without aborting the batch (404 on one ID + 2 successes returns{updated: 2, errors: [{id, status: 404, ...}]}), empty update rejected, emptyidsrejected, bulk delete fan-out, bulk archive callingset_spool_archived(spool_id, archived=True)for each ID, bulk restore the inverse. Fullpytest -n 30green (6384/6384 in 68 s). Frontend behaviour. Selection state is per-page-session — leaving the Inventory tab and coming back clears the set, mirroring the existing label-printer scope. The action toolbar collapses into the existingConfirmModalfor destructive operations (Delete isvariant: 'danger'; Archive / Restore / Reset usage are'warning'). Errors surface via the existinguseToast. API client. AddedbulkUpdateSpools / bulkDeleteSpools / bulkArchiveSpools / bulkRestoreSpoolsand the fourbulkXSpoolmanInventorySpoolsequivalents — matches the per-mode pattern already used forbulkResetSpoolConsumedCounter. i18n. 42 new keys under the newinventory.bulk.*namespace (33 toolbar / modal / confirm + 4 partial-failure toasts × 4 actions + invalid-hex inline helper + 1 useCustom autocomplete affordance), translated in all 11 locales (de / en / es / fr / it / ja / ko / pt-BR / tr / zh-CN / zh-TW). Parity check 5345 leaves per locale, no English fallback. Scope. No DB migration. No new permission. SQLite + Postgres parity verified — the bulk endpoints use the same model + ORM paths as the per-spool routes. Grid (card) view does NOT get checkboxes in this drop — the reporter explicitly requested the Filament-tab list (table view); adding card checkboxes can ship as a follow-up if asked. - Spoolman weight tracking for no-3MF "Untitled" prints (#1820, requested by ojimpo) — Closes a long-standing parity gap between Bambuddy's two inventory modes. When a Bambu print starts that Bambuddy can't fetch a
.gcode.3mffor — typically an unsaved BambuStudio project, where the printer reportssubtask_name: 名称未設定("Untitled") and FTP returns 550 for every candidate path — the existing flow created a fallback archive but Spoolman saw no weight change for that print. The internal-inventory side already handles this via the Path 2 AMS remain%-delta fallback inusage_tracker.on_print_complete(line 517). Spoolman now mirrors the same shape.store_print_datanow capturestray_remain_start(per-slotremain%+tray_uuidat print start) on every print — keyed"<ams_id>-<tray_id>", slots with invalidremain(e.g. -1, AMS hasn't read the spool yet) silently dropped, VT external trays encoded asams_id=255to match internal — and no longer early-returns when the 3MF is missing: it creates anActivePrintSpoolmanrow withfilament_usage=Nonecarrying only the snapshot, so the completion path has something to work with.report_usagekeeps its 3MF path as the primary writer and adds_report_remain_delta_for_slotsfor any slot the 3MF path didn't cover (no-3MF entirely OR partial coverage where slice_info omitted a slot). The fallback resolves each slot to its Spoolman spool via the existingspoolman_slot_assignmentstable, looks up the curatedFilament.weightfrom the spool's filament record, and writes(start_remain - current_remain) × weight / 100grams viaclient.use_spool(...). Notray_weightfrom MQTT — the failure mode #1119 documented (non-RFID spools have no MQTTtray_weight, so remain% × tray_weight gave garbage and silently mis-tracked) is dodged the same way internal inventory dodges it: by reading the user-curated reference weight from the inventory store rather than trusting MQTT's raw field. RFID gate not needed — Spoolman's curatedFilament.weightis present for RFID and non-RFID spools alike. Mid-print spool swap detection — whentray_uuiddiffers between start snapshot and completion read, the slot is skipped rather than mis-attributed. We don't know how much of the print went to which spool; preserving correctness is better than guessing. Double-charge guard — slots already written by the 3MF path land in ahandled_global_tray_idsset that the fallback consults before charging, so a 3MF-covered slot can't also pick up a remain delta. #1119 invariant preserved — the deprecated AMS-remain%-based GLOBAL writer is still gone. This is per-slot, per-print, gated on a valid start/currentremainAND a resolvable Spoolman spool. No new setting, no toggle: the parity rule [[feedback_inventory_modes_parity]] applies — same shape as internal inventory, which is unconditional. No-op default — installs with no Spoolman slot assignments, no RFID-readable AMS, or no print-time remain% (printer offline at start, AMS still loading) see no behaviour change. DB.active_print_spoolmangets a new nullabletray_remain_start TEXTcolumn via_safe_execute(ALTER TABLE … ADD COLUMN), and the existingfilament_usage TEXT NOT NULLis relaxed to nullable — for SQLite viawritable_schema = ON+sqlite_masterpatch +schema_versionbump (same surgical pattern used forusers.password_hashNULL relaxation a few hundred lines below), for Postgres viaALTER COLUMN … DROP NOT NULL. SQLite + Postgres parity verified. CREATE TABLE updated to emit the new shape on fresh installs. Tests. 11 new unit cases intest_spoolman_no3mf_remain_fallback.py: 5 for_snapshot_tray_remain(valid remain captured, invalid remain skipped, VT tray encoding, empty raw_data, missing uuid defaulted to ""), 3 forstore_print_datano-3MF behaviour (row created with snapshot when no 3MF + valid remain; no row when neither 3MF nor remain; 3MF path also captures snapshot for partial-coverage fallback), 3 forreport_usageremain-delta (writes(start-end) × Filament.weight / 100to resolved spool; skips swapped spool whentray_uuidchanged; skips slots already handled by 3MF). Fullpytest -n 30green on the Spoolman + tracking + archive + on-print suites (1205/1205). Backendruffclean. - NTP-gate state exposed on the appliance endpoint —
GET /api/v1/system/appliancegains atime_syncedfield returning"ok","warning", ornull. Source:/run/bambuddy/time-synced, written by the appliance'sntp-gate.shonce chronyd reports sync (or after a 3-minute timeout with a"warning"marker). The RPi 5 has no battery-backed RTC, so on a fresh boot the system clock is wrong until NTP catches up — JWT expiries and TLS certificate validity windows depend on this being right. Newbackend/app/core/local_config.py::read_ntp_gateis defensive on every failure mode (file absent →None, OSError →None+ warning log, empty / unknown content →None, binary garbage survives viaerrors="replace"). The endpoint stays no-auth; the SPA can use the field to render a "time not synced" badge on a fresh appliance before swapping to normal status once"ok"comes through. 8 new unit cases forread_ntp_gate(absent / ok / warning-suffixed / warning-only / empty / unknown-marker / leading-whitespace / binary-garbage) and 3 new integration cases for the endpoint field (ok / warning / absent). On Docker / manual installs the gate file doesn't exist so this is a no-op (time_syncedisnull) — the appliance is the only consumer for now. - Appliance locale defaults endpoint —
GET /api/v1/system/appliancereturns the hostname/timezone/locale the Bambuddy Appliance setup wizard collects into/etc/bambuddy/local.tomlduring firstboot. Newbackend/app/core/local_config.py::read_local_tomlparses the file defensively (missing file → empty dict, invalid TOML → empty dict + warning, non-string values dropped with a warning), so a malformed file never blocks startup. Endpoint returns{hostname, timezone, locale}withnullfor any field not present, requires no auth (the frontend i18n bootstrap fetches it before auth might be set up, and the contents are user-set defaults, not secrets). On the frontend,i18n/index.tsruns a one-shotapplyApplianceLocale()hook after init: gated by abambuddy_appliance_locale_consumedlocalStorage flag so it runs exactly once per appliance, fetches the endpoint, andi18n.changeLanguage(...)s if the returned locale is in the supported set. Non-appliance installs (Docker, manual) silently no-op when the file or endpoint is absent. The appliance writes the file via its setup wizard (separate repo:bambuddy-appliance); this PR closes the loop for the locale field — hostname and timezone are still applied by the appliance's firstboot.sh viahostnamectl/timedatectland don't need a main-app reader. Backend test coverage: 9 unit cases for the reader (missing/empty/comment-only/full/partial/invalid/non-string/unknown-keys/escaped-quotes), 4 integration cases for the endpoint (nulls when no file, full values, partial values, no-auth-required). - Unified print dispatch through the queue scheduler (#1625, by EdwardChamberlain) — Every print Bambuddy starts now goes through the print queue's scheduler rather than the standalone
background_dispatch.pypath that previously ran in parallel for File Manager prints, archive reprints, and printer-card upload-and-print. Same end-state (a print on the printer), one code path. Effect on users: every print is now queueable, cancellable, visible on the queue page, attributable to the user that started it, and runs through the existing filament-deficit check and print-queue ownership model. The "stealth print" that didn't show up in the queue because it bypassed the scheduler is gone. Architecture. File Manager Print, archive Reprint, and printer-card upload-and-print all now POST to the existing queue routes (POST /api/v1/queue/itemswith an immediate ASAP scheduled_time) — the scheduler picks it up on the next tick and runs the same dispatch path the existing queue used to. The retiredbackground_dispatch.pyroute +services/background_dispatch.pyworker + their two test files are removed. The scheduler already had every featurebackground_dispatchdid (per-printer locking, status broadcast, error path) plus the deficit / ownership / queue-position machinery, so this is consolidation rather than a rewrite. Permission scope changes. Documented in the Security section below (#1625 introduced thequeue:createrequirement on File Manager / archive reprint / upload-and-print). i18n. Newqueue.actions.startPrintkey added across all 11 locales (the FileManagerPage button's accessible-name on the new path). Parity check holds. Tests. Allbackground_dispatchtest files removed (the routes they covered no longer exist);test_dispatch_force_timelapse.py,test_scheduler_force_timelapse_wiring.py, andtest_cleanup_forced_timelapse.pyconsolidated onto the scheduler sinceforce_timelapsenow lives there exclusively. Followup #1625-followup (this drop, listed under Fixed below) caught three issues from the post-merge audit — ownership gate mismatch on/queue/{id}/startand/queue/{id}/stop, an ASAP TOCTOU race on empty-scope inserts, and a missing duplicate-position validator on/queue/reorder— none of which were introduced by this PR but all of which became more impactful once every print routed through the queue. Scope. No DB migration. No new permission (queue:createalready existed; this PR widens its surface). No frontend behaviour change for users with full permissions — the queue surface absorbs prints that previously skipped it. - HMS error actions — Resume / Stop / Check Assistant from the dashboard (#1743, by Ichicoro, requested in #1419 by Ichicoro) — Bambu's HMS error dialog goes from read-only to actionable. The error modal on the printer card now renders the same Resume / Stop / Continue / Retry / Check Assistant / Don't Remind Me etc. buttons that BambuStudio and Bambu Handy show, and each click sends the matching MQTT command back to the printer. Closes the long-standing UX gap that forced users to physically walk to the printer (or open Bambu Handy) just to acknowledge a paused print. Data source. A bundled
backend/app/data/hms_actions.jsonmaps every known printer-model + error code to its list of allowable actions; populated from Bambu's publice.bambulab.com/hms/GetActionImage.phpendpoint viascripts/update_hms_actions.py. The action-ID-to-name mapping (RESUME_PRINTING, CHECK_ASSISTANT, FILAMENT_EXTRUDED, …) matches BambuStudio's open-source enum verbatim — including theCANCLEtypo, kept on purpose because Bambu's catalog spells it that way and silently fixing it would break the lookup. Backend. Newbackend/app/services/hms_actions.pydefines anHMSActionStrEnumandget_actions_for_error_code(device, error_code)lookup; loaded once at module import viaPath(__file__).resolve().parent.parent / "data" / ...so the JSON resolves regardless of CWD (systemd unit, Docker entrypoint, pytest frombackend/).BambuMQTTClient._parse_datalooks up the action list at HMS-parse time on both error sources — the structuredhms[]branch and the per-printprint_errorshort-code branch — and attaches it toHMSError.actionstogether with ajob_idsnapshot fromself.state.subtask_idso the action survives a subsequent job change. NewPOST /api/v1/printers/{id}/hms/execute-actionroute (HmsActionBodyschema; permissionPRINTERS_CONTROL) dispatches the click. Dispatcher (BambuMQTTClient.execute_hms_action). Amatchstatement maps eachHMSActionto its MQTT command —resume/stopwitherr+param=reserve+job_idfor the HMS-aware actions;idle_ignorewithtype=0(one-time) vstype=1(persistent) so Bambu's "Don't Remind Me" / "No Reminder Next Time" actually disable the warning across prints;ams_controlwithparam=done/resume/abortfor filament-load dialogs; bareclean_print_error(matches the existingclear_hms_errorsshape — no leakedprint_errorbody field);clean_print_error+uiopchained forDBL_CHECK_OK;refresh_nozzle,buzzer_ctrl mode=0(fire alarm),auto_stop_ams_dry,close_air_filtfor the standalone actions. UI-only actions (CHECK_ASSISTANT,JUMP_TO_LIVEVIEW,OK_JUMP_RACK,REMOVE_CLOSE_BTN,LOAD_VIRTUAL_TRAY,CANCLE,DBL_CHECK_CANCEL) intentionally publish nothing — they exist for label parity with BambuStudio's modal where the printer's own screen drives them. Unknown actions fall through toreturn False+ warn log so the route surfaces them as 4xx rather than silently no-opping. Every command pairs with apushing.pushallecho so the state stream refreshes on the next tick and the modal closes correctly. Schema hardening.HmsActionBody.print_errorvalidated asmin/max_length=8+pattern=r"^[0-9A-Fa-f]{8}$";actionandjob_idlength-capped. Stray input can't reach the dispatcher'smatch. Frontend.HMSErrorModal.tsxrenders a wrap-flex row of buttons under each error description, sized to fit on the printer-card panel without overflowing on narrow viewports. The mutation calls the new endpoint, invalidates the printerStatus query, and shows the newhmsErrors.actionSuccess/hmsErrors.actionFailedtoast. The button label is the translated action name fromhmsErrors.actions.<ACTION_NAME>— never the raw enum — so a forgotten translation falls back to the English action name rather than a key string. i18n. 33 action labels + 2 toast keys translated in all 11 locales (de / en / es / fr / it / ja / ko / pt-BR / tr / zh-CN / zh-TW). No English fallback per [[feedback_translate_dont_fallback]]. Parity check 5381 leaves per locale. Tests. 31 new cases intest_hms_actions.py— 5 catalog-lookup (known A1 error returns actions; unknown device → empty; unknown error → empty; underscore-form0300_8070doesn't match the catalog's no-separator key; enum StrEnum value contract holds including theCANCLEtypo) and 26 dispatcher cases that pin everyHMSActionbranch to its exact MQTT payload — resume carries err+param+job_id;IGNORE_RESUME/NO_REMINDER_NEXT_TIMEuseidle_ignore type=0;IGNORE_NO_REMINDER_NEXT_TIME/DONT_REMIND_NEXT_TIMEusetype=1(persistent variants — were incorrectly bucketed together in an earlier draft);clean_print_errorbody is bare;DBL_CHECK_OKchains clean + uiop_close; uiop'serris the already-string short code (notf"{x:08X}"against a str, which would TypeError); plain resume vs HMS-aware resume distinguished; UI-only actions publish nothing; unknown action returns False;pushing.pushallecho fires after every command. Fullpytest -n 30green (6471/6471). Backendruffclean. Frontendnpm run buildclean. Scope. No DB migration. No new permission. The HMS modal is opt-in by user click — installs with no HMS errors see no behaviour change. The 9009-line catalog is shipped as a single static JSON; regenerating it later is apython scripts/update_hms_actions.pyrun away. - Inline finish-photo embed in failure-event emails +
user_print_*template disambiguation (#1792, reported by elit3ge) — Two related changes to the notification stack. (1) Template-driven inline finish-photo in email. Pushover / Telegram / Discord / ntfy users already get the finish-photo JPEG attached to terminal-print notifications (print_complete/print_failed/print_stoppedevent types), thanks to the capture path shipped in 0.2.5b1 (#1397) that extracts the last timelapse frame at print end and loads up to 2.5 MB intoarchive_data["image_data"]. Email was the one provider that dropped those bytes on the floor — text-only body, no visual context for the reporter's "Reason: unknown" failure mails.notification_service._send_email(backend/app/services/notification_service.py:413) now acceptsfinish_photo_urlalongsideimage_dataand the dispatcher (_send_to_providerat:745) threads the URL from the rendered template variables dict. Inline embed is opt-in via the existing{finish_photo_url}template variable — first draft of this fix unconditionally inlined the photo whenever bytes were present, which maziggy correctly flagged as bypassing the template system ("standard is to have variables for all available items in a template"). The contract now: if the user puts{finish_photo_url}in their email template body, the URL substring in the rendered body triggers the multipart/related shape — HTML part replaces the escaped URL in-place with<img src="cid:bambuddy-finish-photo">(so the image appears WHERE the variable was, not stapled to the bottom), plain-text part keeps the URL as a clickable link, MIMEImage attached inline withContent-ID: <bambuddy-finish-photo>per RFC 2392. If the template doesn't reference the variable, single-part text-only — no surprise image. Default templates are unchanged; reporter (and any user who wants this) edits theirprint_complete/print_failed/print_stoppedbody once to add the variable. XSS hygiene: rendered body ishtml.escaped before the URL→<img>swap, newlines become<br>. Pushover/Telegram/Discord/ntfy senders untouched — their pre-existing "auto-attach wheneverimage_datais set" behaviour stays because their bodies aren't HTML-templatable for inline images anyway. (2)user_print_*template names get an " Email" suffix. Same reporter surfaced a separate confusion: the Message Templates list showed "Print Completed" and "User Print Completed" side-by-side with no cue they're different dispatch paths — the first is a provider-level broadcast to whatever notification channels the admin configured (ntfy/pushover/telegram/discord/email/webhook/homeassistant), the second is a per-user SMTP-only email to the user who submitted the job (requires advanced auth +user_notifications_enabledtoggle + user has email + per-user pref opt-in). TheEVENT_NAMESdisplay map inbackend/app/api/routes/notification_templates.py:51already used the disambiguated "User Print Completed Email" label, but the seed wrote the short name to the DB, so the UI rendered the ambiguous one. Fresh installs now get the suffixed name straight fromDEFAULT_TEMPLATES(backend/app/models/notification_template.py:198+). Existing installs get the rename via a new_migrate_rename_user_print_template_names(backend/app/core/database.py:3081+) that runs on startup and updates rows for the fouruser_print_*event types WHERE the name still matches the old default — admin-edited names are preserved. Standard SQL UPDATE works on both SQLite and Postgres without dialect branching. Tests: 6 newTestEmailProvidercases inbackend/tests/unit/services/test_notification_service.pypinning the template-driven contract (no-image-no-URL → text-only, image-without-template-reference → STILL text-only, URL-in-body + bytes → multipart/related with cid, URL-arg-missing → text-only defence-in-depth, body-escape hygiene, URL→<img>in-place swap). 5 new migration cases inbackend/tests/unit/test_user_print_template_rename_migration.pycovering default-rename, user-edited preservation, provider-template don't-touch, second-run idempotency, empty-table fresh-install no-op. 11/11 + 140/140 adjacent notification tests green. Ruff clean. Verified end-to-end against a real SMTP provider with a real 48 KB finish-photo JPEG — Gmail rendered the inline image where the URL marker was in the body. - Dedicated "AI Failure Detection" notification event (#1794, reported by maziggy from a user report) — Obico failure detection now fires its own notification event (
on_ai_failure_detection) instead of riding the multiplexedon_printer_errortoggle. Reporter (P1S, Discord provider) had Obico enabled withobico_action=notify, detection was firing correctly per the logs, every other Discord notification was working — but spaghetti detections never reached Discord. Root cause.obico_actions._notifyatobico_actions.py:75was callingnotification_service.on_printer_error(..., error_type="ai_failure_detection"). The notification service's provider filter atnotification_service.py:722-725requires the SUBSCRIBED-event boolean column to be True; theon_printer_errorcolumn defaults to False; the reporter's Discord provider was created without explicitly enabling Printer Error. The user couldn't have found the right toggle even if they'd known to look — the UI labels it "Printer Error" with no hint that flipping it also subscribes to AI detection. The same toggle multiplexed three distinct events (HMS hardware errors atmain.py:1248+ Obico spaghetti + aerror_type="ai_failure_detection"discriminator passed in the variables payload), so a user who wanted spaghetti alerts but not chamber-fan-stalled HMS pages had no way to express that. Fix. Newon_ai_failure_detectionBoolean column onnotification_providers(defaults False — matches the conservative default of every other opt-in event); newnotification_service.on_ai_failure_detection(printer_id, printer_name, task_name, confidence, action, db, image_data)method following the exact shape ofon_printer_error(mirrors variable handling, template fan-out, provider filter, fail-open under quiet-hours / digest); newai_failure_detectiontemplate entry seeded byseed_notification_templateswith variables{printer},{task_name},{confidence},{action}. The seeder only adds templates whoseevent_typeis missing, so existing installations get the new template on next start without clobbering customised ones.obico_actions._notifyswapped to the new method. Migration. Branched SQLite (DEFAULT 0) vs Postgres (DEFAULT false) per the existing stock-alert migration shape atdatabase.py:2750— Postgres rejectsDEFAULT 0for BOOLEAN columns. Existing providers receive the column with the conservative False default; they continue NOT receiving Obico notifications UNTIL they explicitly toggle the new "AI Failure Detection" event ON. This is the intended UX: previously the toggle was onPrinter Error, which the reporter had OFF, so today they get nothing; after this change they still get nothing until they opt in via the dedicated toggle, but now they can find the toggle without trial-and-error. Frontend. New toggle row inNotificationProviderCard.tsx(between Printer Error and Low Filament) with a description line "Notify when Obico AI detects a possible print failure" so users discover the link to Obico without having to read source. New summary badge ("AI Failure Detection" in fuchsia) in the collapsed card view so admins can see at a glance which providers route AI alerts. New toggle inAddNotificationModal.tsxPrinter Status section with matching state hook (onAiFailureDetection) wired through the create + update payload. ntfy per-event priority block also picks up the new event when enabled, matching how Printer Error and the stock-alert events behave there. Schema.NotificationProvidermodel +NotificationProviderBase/NotificationProviderUpdateschemas +_provider_to_dictroute serialiser + create route + PATCH route (the latter usesmodel_dump(exclude_unset=True)so it picks up the new field automatically). FrontendNotificationProvidertype + the update-payload variant. i18n. Two new keys —notifications.aiFailureDetection(label) andnotifications.aiFailureDetectionDescription(help text) — translated in all 11 locales (de / en / es / fr / it / ja / ko / pt-BR / tr / zh-CN / zh-TW). Parity check 5242 leaves per locale, no English fallback. Tests. 4 new backend cases intest_notification_service.py::TestAIFailureDetectionNotifications(dispatch uses the new event field — NOT the legacy multiplexed one; provider with onlyon_printer_error=Trueis NOT notified — the regression guard for the reporter's symptom; variables include task_name + 2-decimal-formatted confidence + action; empty task_name falls back to "current job"). 3 new backend cases intest_obico_actions.py(execute_action(action='notify')callson_ai_failure_detectionand explicitly does NOT callon_printer_error; thepauseaction still pauses + notifies; notification-service exceptions are swallowed so a transient Discord blip can't kill the Obico detection loop). 5 new frontend cases — 4 inNotificationProviderCardAiFailureDetection.test.tsx(badge renders when ON; absent when OFF; toggle appears in expanded settings; toggling PATCHes the correct field and explicitly NOTon_printer_error) and 3 inAddNotificationModal.test.tsx(toggle renders in Printer Status section; save persists the new field without touchingon_printer_error; ntfy priority block includes the event when enabled). Existing 87test_notification_service.py+ 52 Obico tests + 65NotificationProviderCard*/AddNotificationModal*tests still green. Backendpytest -n 30clean; ruff clean;npm run buildclean; ESLint clean. Scope. No change to HMS hardware-error notifications —main.py::on_printer_errorcallers still fire theon_printer_errorevent witherror_typeshapes like"AMS Error"/"Heating Error", unchanged. Theon_printer_errorcolumn stays on the table (default False, used for HMS only). Users who had it ON for HMS errors keep getting HMS notifications; what they LOSE is silent AI-failure dispatch on the same toggle, which most users with HMS-on never received anyway becauseerror_type="ai_failure_detection"was the same valueobico_actions._notifyhardcoded. The full Obico action surface (notify/pause/pause_and_off) is unchanged on the dispatch side —execute_actionstill pauses + cuts plug power forpause_and_off; the only thing that moved is which notification-service method runs the fan-out. - Page-wide drag-and-drop upload on the File Manager (#1510, requested by maikolscripts) — File Manager gains the same drag-and-drop upload surface that the Archives page has had: drop any file anywhere on the page and the upload modal opens pre-populated with the dropped files, no need to click the Upload Files button first. The hardcoded
"Upload 3MF"flow was the only path before this change. Unlike the Archives variant — which filters dropped files to.3mfonly — the File Manager drop zone accepts whatever the upload modal itself accepts (3MF, STL, ZIP, images), so the page-wide surface is never more restrictive than the button it shortcuts. Permission-gated onlibrary:uploadso a viewer-tier user can't accidentally trigger the overlay. Shared hook.frontend/src/hooks/usePageFileDrop.tsis the new home for the drag-handler set —isDraggingOverstate,dragHandlersto spread on the wrapper, optionalextensionsfilter, optionalonRejectedcallback for "you dropped something we won't accept" toasts,disabledflag for permission gating. Archives and File Manager both consume it; future drop-zones can opt in without re-implementing the cancel-safe logic.FileUploadModal.initialFilesprop. Modal accepts aFile[]to pre-seed itself on first mount via aseededInitialRefguard so the same files don't re-add on subsequent renders. Existing manual-open paths (Upload Files button) pass nothing and behave unchanged. i18n. New keyfileManager.releaseToUploadtranslated in all 11 locales (en: Release to upload, de: Loslassen zum Hochladen, es: Suelte para subir, fr: Relâcher pour téléverser, it: Rilascia per caricare, ja: 離してアップロード, ko: 놓아서 업로드, pt-BR: Solte para enviar, tr: Yüklemek için bırakın, zh-CN: 释放以上传, zh-TW: 釋放以上傳); existingfileManager.dropFilesHerereused. Parity 5240 leaves × 11 green, no English fallback. Tests. 13 new cases insrc/__tests__/hooks/usePageFileDrop.test.tsxcovering: overlay on dragenter, non-file payload ignored, child-element dragLeave keeps overlay (relatedTarget inside wrapper), outside-element dragLeave hides it, null relatedTarget hides it (cursor left window), document drop / dragend / Escape all reset (the three cancel paths the prior inline implementation missed — see the Fixed entry), drop with mixed file types filters by extension, onRejected fires when extension filter drops everything, disabled is a no-op, overlay clears on successful drop. Existing 85 cases across ArchivesPage / FileManagerPage / FileManagerExternalFolder vitest still green. ESLint clean;npm run buildclean. - Sort Printers page by ETA (#1609, requested by forgecrafttechnologies-source) — The Printers page sort dropdown gains a fifth option, ETA, beside the existing Name / Status / Model / Location. Sorts the fleet by remaining print time so the printer that's finishing next sits at the top — the reporter's use case is staging the next job's filament ahead of time without scanning every card. Tier ordering. Tier 0 = currently printing with a known
remaining_time > 0, sorted ascending by remaining minutes (soonest first); Tier 1 = currently printing without an ETA yet (post-start_printwindow before the slicer reports total time); Tier 2 = idle / finished; Tier 3 = offline. Tiebreaker within every tier is printer name, so two printers with the same ETA — or two idle printers — stay in a stable alphabetic order. The ascending / descending direction button still applies after tiers resolve, so descending puts offline printers at the top for operators triaging the fleet for connectivity issues. Data source. The cachedremaining_time(minutes) on the per-printer status query (['printerStatus', id]) — the same field the per-card "ETA … min" label already reads from onPrintersPage.tsx:3633and the fleet-wide "next finish" badge already aggregates onPrintersPage.tsx:996. No new backend query, no new round-trip; the sort consumes data that's already in the React Query cache and updated on every WebSocket push. No grouping. Unlikestatus/model/locationsorts (which group rows under section headers), the ETA sort renders a flat list — each printer's ETA is unique so grouping would just produce a header per row. i18n. New keyprinters.sort.etatranslated in all 11 locales (en: ETA, de: Restzeit, es: Tiempo restante, fr: Temps restant, it: Tempo rimanente, ja: 残り時間, ko: 남은 시간, pt-BR: Tempo restante, tr: Kalan süre, zh-CN: 剩余时间, zh-TW: 剩餘時間), no English fallback. Parity check 5239 leaves per locale, green. ESLint clean;npm run buildclean. - File Manager: user-authored tags for cross-cutting file filtering (#1268, requested by zumik3-del, seconded by unLieb) — Third and final piece of #1268, shipped alongside the recursive-search + markdown-description-panel changes below. Folders are the hierarchy (every file lives in exactly one); tags are the orthogonal labels ("toy", "kid-safe", "petg-only", "failed twice", "gift") and a single file can carry as many as the user wants. Reporter wanted to find "every toy regardless of which folder it lives in" — folders alone can't do that without forcing files into one bucket. Catalog model. New
library_tagstable (id, name, name_key UNIQUE =LOWER(TRIM(name)), timestamps) holds the global tag catalog — one set per install, not per-user (matches the Locations PR #1505 from earlier in 0.2.5b1).name_keyUNIQUE on a normalised key collapses "Toys" / "toys" / " TOYS " into a single row so users can't accidentally fragment the tag space by typing variations. Newlibrary_file_tags(file_id, tag_id)composite-PK association table withON DELETE CASCADEon both sides — deleting a tag drops every chip from every file (files survive); deleting a file drops its tag links (catalog rows survive). Both tables auto-create viaBase.metadata.create_all()at init — no explicitrun_migrations()step needed since they're greenfield. API. New/library/tagsrouter (backend/app/api/routes/library_tags.py) withGET(list + per-tagfile_countprojected via subquery; filtered by ownership forLIBRARY_READ_OWNusers so chip counts match what they'd actually see),POST(create — strips whitespace, 409 on case-insensitive dup with both pre-check AND post-commit IntegrityError catch for race safety),PATCH /{id}(rename, same 409 rules, self-rename allowed via id-exclusion in the pre-check),DELETE /{id}(cascade), andPOST /library/tags/bulk-assignfor multi-file ops. Bulk-assign supports three actions:add(idempotent — re-applying doesn't 409, just no-ops for pre-existing pairs, count reports what actually changed),remove, andreplace(strip everything currently on the listed files, then INSERT the new set — passing emptytag_idswithreplaceclears the file's tag set entirely). Per-file ownership enforced forLIBRARY_UPDATE_OWNusers via a pre-filter onfile_ids(silently drops files the caller can't update — same posture aslibrary_trashbulk routes; the response counts reflect what actually happened so the UI can detect partial application). Unknownfile_ids(race with a deleter, stale FE selection) are silently dropped instead of 404'ing the whole call.list_filesextension. Newtag_ids: list[int]query param on the existing/library/filesroute — repeated?tag_ids=N&tag_ids=Mstyle. AND semantics: JOIN the association,GROUP BY file.id HAVING COUNT(DISTINCT tag_id) = len(tag_ids), portable across SQLite and Postgres. Per the design discussion, the tag filter intentionally bypasses folder scoping (folder_id/project_id/include_root/recursiveare all skipped whiletag_idsis non-empty) — the whole point of tags is cross-cutting "every file matching these labels regardless of where it lives". Every file in every listing response now carriestags: list[{id, name}]viaselectinload(LibraryFile.tags)so chip rendering on the FE is N+1-free. Frontend —LibraryTagsModal. Catalog CRUD modal opened from the File Manager toolbar's new Tags button, max-w-4xl wide so multi-language subtitles don't wrap. Table with name + file count + rename/delete actions; row-click pushes the tag into the active filter and closes the modal. Delete confirm-dialog warns specifically whenfile_count > 0("This tag is on N file(s). Deleting removes the chip from all of them; files themselves are untouched."). Same Esc / backdrop / mid-mutation guard shape asLocationsModal. Frontend —BulkTagsPickerModal. Opens from the File Manager's multi-select toolbar (new Tag button between Move and Delete). Add/Remove radio at the top, scrollable checkbox list of catalog tags, inline "create new tag" affordance disabled on case-insensitive dup against the existing list, Apply button disabled until ≥1 tag is selected. Thereplaceaction is exposed in the API but deliberately NOT in the UI — arbitrary multi-file replace is destructive and confusing; future bulk-edit screen can opt in later. Frontend —FileManagerPageintegration. NewselectedTagIds: number[]state, sorted into theuseQuerykey so the cache hits are stable regardless of toggle order. Tag catalog shared with the modals via['library-tags']query key (extracted tofrontend/src/utils/libraryTagsQuery.tsto satisfy Vite's react-refresh rule that component files export only components).useEffectprunesselectedTagIdswhen a tag is deleted from the catalog so the filter never strands on a phantom id. Filter rail above the file list lists EVERY catalog tag as a togglable chip — inactive chips are outlined and muted, active chips are filled bambu-green with an X, click toggles. "Clear all" appears only when ≥1 tag is active. Hidden entirely when the catalog is empty so fresh installs don't see a stray bar. List view gets a dedicated Tags column atminmax(0, 200px)between Prints and Actions — placed after the existing data attributes since tags are a "file attribute". Empty state shows a-to keep the column shape consistent. Grid view chips render below the metadata block in each FileCard. Chip clicks in both views push toselectedTagIds; click propagation is stopped so a chip click doesn't toggle the file's selection state. Type safety.LibraryFileListItem.tags?: LibraryTagSummary[]is OPTIONAL even though the backend always emits an empty array, because legacy msw mocks in pre-existing tests (FileManagerPage / FileManagerExternalFolder) construct partial file shapes without the field — without the?the renderer crashed on.length. Read sites usefile.tags ?? []and the!.non-null assertion only inside the inner&&guard. Dependencies. Zero new deps. The whole tag UI reuseslucide-react'sTagicon, existing button/modal primitives, andtanstack/react-queryalready in the bundle. Bundle size unchanged from the previous 0.2.5b1 baseline (7,876 KB raw / 2,122 KB gzip). Tests. 15 backend integration cases inbackend/tests/integration/test_library_tags_api.py— CRUD: create + list, strip-whitespace, case-insensitive dup 409 across "Toys"/"toys"/"TOYS"/" ToYs ", rename, rename-collision 409, self-rename allowed, delete cascades associations but keeps files, delete-unknown 404. Bulk: add idempotency (second call adds 0, file_count stays 1), remove drops only listed tags (peer tag stays), replace-with-empty clears, unknown file ids silently skipped, invalid action 422. Filter: AND across two tags returns only the intersection file, tag filter overrides folder_id (file from another folder still appears when the tag matches), file listing includes the tags array. 15/15 green plus 102/102 acrosstest_library_api.py+test_library_trash_api.py(no regression). 8 frontend cases — 4 inLibraryTagsModal.test.tsx(renders + count, create flow PATCHes correctly, row click → onPickTag + close, in-use delete warning), 4 inBulkTagsPickerModal.test.tsx(lists tags, check + Add calls bulkAssign with action='add' and the right file/tag arrays, Remove radio + Apply uses action='remove', Apply disabled when no tag selected). Full vitest run: 2249/2249 across 170 test files. Full backendpytest -n 30: 6341/6341. i18n. 37 new keys underfileManager.tags.*namespace (modal title/subtitle, manage/manageTitle, add/edit, name/fileCount, empty/noMatches, createPlaceholder/createButton, nameRequired, searchPlaceholder, CRUD success/failure toasts, applyAdd/applyRemove + their success messages, actionAdd/actionRemove radio labels, tagAction button, bulkTitle, bulkTooltip, noPermission, filterLabel, clearAll, confirmDelete + the in-use variant, editAria/deleteAria). Translated in all 11 locales (de / en / es / fr / it / ja / ko / pt-BR / tr / zh-CN / zh-TW). Parity check 5292 leaves per locale, no English fallback (thedefaultValue: "..."shortcut from a first-draft modal was removed precisely so the parity check would fail loudly if any locale missed a key). Permissions. Catalog mutations requireLIBRARY_UPDATE_ALL(the catalog is global — ownership-aware update isn't meaningful for a row no user owns). Bulk-assign uses the existingLIBRARY_UPDATE_ALL/LIBRARY_UPDATE_OWNownership pair. GET usesLIBRARY_READ_*with the file-count projection narrowed for*_OWNcallers. No new permission constants, no new RBAC migration. Out of scope (deferred to v2 if asked). Tag colors / icons (label-only chips per design decision #1), tags onprint_archivesrows (different mental model — archives are completed prints), auto-tags derived from 3MF metadata categories (kept user-authored per design decision #4), import/export of the tag set, tag-filter intersected with folder scoping (the design call was that cross-cutting filter overrides folder selection — adding an "AND folder" toggle would need separate UX work). Closes #1268 alongside the recursive-search and markdown-description-panel pieces below — all three deliverables in this issue ship in the same minor. - File Manager: recursive search and per-folder markdown description panel (#1268, requested by zumik3-del, second by unLieb) — Two of the three asks bundled in #1268; the third (tags) is gated on the community-interest check Martin posted there. (1) Recursive search inside the selected folder. Until now, picking "Toys" in the sidebar and typing
robotonly found files inToys/itself — anything underToys/Cars/orToys/Cars/Race/was invisible until the user manually drilled in. The page's client-side filter was running over a server-narrowed list (/library/files?folder_id=Xis strict equality onfolder_id), so search couldn't see what the listing didn't load. Newrecursive=truequery param on/library/fileswalks thelibrary_folders.parent_idtree via a recursive CTE rooted at the requestedfolder_idand returns every descendant folder's files in one round-trip. Recursive CTEs work on both SQLite (≥3.8.3, shipped 2014 — Bambuddy's floor is well above that) and Postgres without dialect branching. Default off so the existing folder-browsing call sites (Project / Archive detail pages, the FE's no-search case) keep their narrow single-folder semantics — only the FE's search bar opts in, and only when both a folder is selected ANDsearchQuery.trim()is non-empty. A small "Including subfolders" hint renders under the search input when the recursive request is active so the user understands why a file from two folders away showed up. (2) Per-folder markdown description panel. New endpointGET /library/folders/{folder_id}/readmereads the first.mdfile in the folder and returns{filename, content, truncated}. Selection prefersREADME.md/readme.md/description.md(case-insensitive — picked viafunc.lower(filename) LIKE '%.md'filter + an in-Python stem-preference sort), falls back to the alphabetically-first*.mdotherwise. 404 when no markdown file is present so the FE can hide the side panel — non-users pay no UI cost. Bytes are clipped at 512 KiB (_README_BYTES_CAP) with atruncatedflag so the panel can warn the reader; UTF-8 decode useserrors="replace"so one bad byte never blanks the panel. NewFolderReadmePanel.tsxcomponent fetches the README on folder-select, renders it viareact-markdown9+remark-gfm4(tables / strikethrough / task lists), collapsible (default expanded), max-height 24rem with internal scroll. react-markdown 9 doesn't render raw HTML by default — XSS safe without dompurify. Links open in a new tab withrel="noopener noreferrer". Tailwind has no typography plugin in this project so per-element components map h1/h2/h3/p/ul/ol/code/blockquote/table/etc. to explicit utility classes that match the rest of the app's look. Both ask 1 and 2 ship as one PR because they share scope (file-manager UX), the same reporter, and the same review surface; ask 3 (tags) is held back as gated on the public interest signal Martin requested in his comment ("If you'd find this feature useful, please give this issue a thumbs up"). Backend.list_filesroute atbackend/app/api/routes/library.py:1729+gains therecursive: bool = Falseparam + the recursive-CTE branch. Newget_folder_readmeroute at:1042+with_README_BYTES_CAPconstant +_README_PREFERRED_STEMSselection tuple. NewFolderReadmeResponseschema inbackend/app/schemas/library.py:66+. Frontend.api.getLibraryFilesatfrontend/src/api/client.ts:5785+gains therecursive = falseparameter;api.getLibraryFolderReadmeis the matching helper for the new endpoint.FileManagerPage.tsxderivessearchExpandsSubfoldersfromselectedFolderId !== null && searchQuery.trim().length > 0and threads it into both theuseQuerykey (so toggling search refetches with the new scope) and the API call. The newFolderReadmePanelmounts above the file list whenselectedFolderId !== null. Dependencies.react-markdown ^9+remark-gfm ^4added tofrontend/package.json(~30 KB gzipped — single use-site for now, but reusable for any future markdown surface — print-archive notes, custom-field docs, etc.). No new backend dependency. Tests. 6 backend integration cases inbackend/tests/integration/test_library_api.pypin the contract:recursive=truewalks a three-level tree and returns files from all levels but NOT a sibling unrelated branch;recursive=truewithoutfolder_idis a no-op (the existinginclude_rootbranch still handles scoping); README endpoint returns the first .md with the correct on-disk content; README endpoint prefersREADME.mdovernotes.mdeven whennotes.mdis inserted FIRST andreadme.mdis lowercase; 404 when the folder has no .md; 404 when the folder doesn't exist. 3 frontend cases insrc/__tests__/components/FolderReadmePanel.test.tsxcover: 404 hides the panel (no leaked chrome), markdown content renders viafindByRole('heading'), truncated flag surfaces a chip. Full backendpytest -n 306326/6326 green; frontend vitest 1094/1094 component cases green; ruff clean;npm run buildclean. i18n. 2 new keys —fileManager.searchSubfoldersHint(the small under-search caption) +fileManager.readme.truncated(the chip label when the markdown was clipped). Translated in all 11 locales (de / en / es / fr / it / ja / ko / pt-BR / tr / zh-CN / zh-TW), parity check 5255 leaves per locale, no English fallback. Scope. No new permission — both endpoints reuse the existingLIBRARY_READ_ALL/LIBRARY_READ_OWNownership-aware permission pair (so a viewer-tier user withread_ownonly sees their own files in recursive listings + can only request the README of folders containing their own files). No DB migration. The recursive CTE is a single SQL query — no N+1, no per-folder round-trip, scales to deeply-nested model libraries. - By-tag spool lookup, readable with a Manage-Inventory API key (#1700 closing #1663, reported + contributed by bambuman) — Companion to the QR-code-API-key flow below: gives bambuman's BambuMan NFC inventory app — and any future scanner-driven Bambuddy integration — a way to dedupe a spool scan with a single, narrowly-scoped API key. New endpoint:
GET /inventory/spools/by-tag?tray_uuid=…&tag_uid=…&include_archived=false.tray_uuidis the primary identifier (it's the same 32-char hex the AMS reports over MQTT, so the scan can match a spool that's already linked to the printer),tag_uidis the fallback. At least one must be supplied (400 otherwise); 404 when nothing matches. Both values are passed throughnormalize_tray_uuid/normalize_tag_uidfrom `
Changelog truncated — see the full CHANGELOG.md for the complete list.