Real-time Monitoring¶

Bambuddy provides live monitoring of all your connected Bambu Lab printers through WebSocket-based real-time updates.

Search & Filters¶

Large print farms are hard to navigate on a phone where Ctrl+F isn't an option. The Printers page has a live search bar and two filter dropdowns above the card grid.

Live Search¶

Type into the search bar to filter the card grid in real time. The search matches any of the following fields (case-insensitive, whitespace-trimmed):

• Printer name
• Printer model (e.g., X1C, P1S, A1 mini)
• Location
• Serial number

Click the button inside the search bar to clear it.

Status Filter¶

The status dropdown filters by current printer state:

The status filter is reactive to WebSocket updates — when a print finishes and the printer transitions from RUNNING to FINISH, it is immediately removed from the "Printing" view without needing a manual refresh.

Location Filter¶

The location dropdown appears only when at least one printer has a location configured. It lets you quickly narrow the view to a single workshop, rack, or room. Location values are taken directly from each printer's configured location.

Combining Filters¶

Search, status, and location filters combine — a matching printer must pass all three checks. An empty-state message appears if no printer matches the current combination; clear the search bar or reset the dropdowns to see everything again.

Resizable Printer Cards¶

Adjust the size of printer cards to fit your screen and workflow:

Card Sizes¶

Adjusting Size¶

1. Look for the + and - buttons in the Printers page toolbar
2. Click + to increase card size
3. Click - to decrease card size
4. Size preference is saved automatically

Status Summary Bar¶

The status summary bar at the top of the Printers page provides an at-a-glance overview of your fleet:

Availability & Counts¶

Next Available Printer¶

When at least one printer is actively printing, the bar shows which printer will finish soonest:

• Printer name — the printer closest to completing its current job
• Progress bar — visual completion indicator
• Percentage — current print progress
• Time remaining — estimated time until the printer becomes available

Printer Status¶

Each printer card displays real-time information:

Connection Status¶

Temperature Readouts¶

Live temperature readings update every few seconds:

Heater History¶

Every heater tile on the printer card carries a small chart icon (top-right corner). Click the tile body to open the existing target-temperature popover; click the chart icon to open the heater history modal for that sensor.

Bambuddy records nozzle, bed, and chamber readings every 60 seconds (alongside the matching target value) so you can review thermal behaviour after a print:

Retention¶

Heater data is kept for 30 days by default. Adjust this under Settings → General → Printer Sensor History Retention if you need a longer or shorter window. Old rows are purged automatically once every ~24 hours by the recorder loop; a manual purge per printer is available via DELETE /printer-sensor-history/{printer_id}?days=N (requires the printer_sensor_history:read scope, included by default in the Operators and Viewers groups).

Nozzle Details (H2 Series)¶

H2 series printers show extended nozzle information on hover:

Fan Status¶

Real-time fan speed monitoring in the Controls section:

Fan badges always display with dynamic coloring:

• Active (colored): Fan is running, shows current speed %
• Inactive (gray): Fan is off, shows 0%

A print speed badge () also appears in this row, showing the current speed preset percentage. See Printer Control > Print Speed for details.

Fan speeds update in real-time via WebSocket alongside temperatures.

Compact Mode Status Pip¶

In compact (Small) view, each printer card shows a small colored status pip:

Hover over the pip to see the number of active HMS errors.

Print Progress¶

When a print is active, you'll see:

• Progress bar - Visual completion percentage (turns amber when paused)
• Current layer - Layer X of Y
• Time remaining - Estimated time to completion
• Filament used - Grams consumed so far

Status Sorting¶

When sorting by status, printers are ordered by priority:

1. HMS errors — printers with active HMS errors appear first
2. Printing — printers running a job
3. Idle — connected with no active job
4. Offline — disconnected printers

This makes it easy to spot printers that need attention in large print farms.

ETA Sorting¶

When sorting by ETA (estimated time of arrival / remaining print time), printers are ordered so the next finish lands at the top — useful for staging the next job's filament ahead of time:

1. Printing with a known ETA — soonest finish first, ascending by remaining minutes
2. Printing without an ETA yet — the brief window between starting a print and the slicer reporting total time
3. Idle / finished — connected, no active job
4. Offline — disconnected

Printers with the same ETA (or no active print) fall back to alphabetical order so the list stays stable across refreshes. The sort-direction button still flips the result — descending puts offline printers at the top for fleet-wide connectivity triage.

The ETA sort renders a flat list (no section headers), since every printer's ETA is unique.

Collapsible Groups¶

When sorting by Status, Model, or Location, printers are rendered inside collapsible section headers — click a header to expand or collapse that group. The Name and ETA sorts render a flat grid.

• Each group's collapsed state persists across page refreshes (stored per-browser in localStorage).
• In selection mode, each section header shows a Select All button that selects every printer within that group.
• Status groups appear in priority order (Error → Printing → Paused → Finished → Idle → Offline); the sort-direction toggle flips the order.

HMS Error Monitoring¶

The Health Management System (HMS) monitors printer health and displays issues in real-time.

Status Indicator¶

The HMS indicator is always visible on printer cards:

Error Details¶

Click the HMS indicator to see:

• Human-readable error description (853 codes translated)
• Error code for reference
• Affected component
• Recommended action
• Link to Bambu Lab support article

Error Actions (Resume / Stop / Check Assistant / …)¶

Each error in the modal now shows the same action buttons that BambuStudio and Bambu Handy display — Resume Printing, Stop Printing, Continue, Retry, Filament Extruded, Check Assistant, Don't Remind Me, Recheck, and so on, depending on what Bambu's catalog lists for that specific error on your printer model.

Click any button and Bambuddy sends the matching MQTT command back to the printer. The wire shapes mirror BambuStudio's DeviceErrorDialog / DeviceManager source so the printer sees the same payload regardless of which client sent it:

• Resume Printing / Resume (defects acceptable) / Resume (problem solved) / Problem Solved and Resume / Filament Loaded, Resume / Proceed → resume command. Tells the firmware "I handled the problem, re-check normally and continue." For faults that re-trigger on resume (e.g. a genuinely wrong plate), the printer will re-detect and re-pause with the same code; use Ignore this and Resume instead for that semantic.
• Ignore this and Resume / Ignore. Don't Remind Next Time / Don't Remind Me → ignore command. Distinct from Resume: tells the firmware "suppress the next re-check of this specific fault AND resume the paused print" in one operation. The err field carries the decimal int value of the error code (matching BambuStudio's wire format); job_id carries the active subtask id so the firmware knows which print's check to skip.
• No Reminder Next Time → idle_ignore with type=0. Dismisses the dialog on the printer's touchscreen without resuming; the firmware suppresses one re-display of the same warning.
• Stop Printing → stop command. Aborts the print from the paused state and the printer transitions to FAILED.
• Filament Extruded / Continue / Retry / Abort (filament-load dialogs) → ams_control with param=done / resume / abort.
• OK / Confirm → clean_print_error (the same command the explicit "Clear Errors" button uses).
• Check Assistant, View Liveview, Close, Cancel — these are surfaced for parity with BambuStudio's modal but don't have an MQTT counterpart; the printer's own touchscreen drives them. Bambuddy renders the buttons so you have label parity, but clicking them is a no-op on the wire.

After a button click Bambuddy waits up to 2.5 s for the printer to push at least one MQTT status update; if no push arrives the action is reported as Printer did not acknowledge HMS action rather than a silent success. This catches firmware-side silent rejection (broker ACKs the publish but the printer drops the command — e.g. an err format mismatch).

Which buttons appear is determined by the printer model (X1C, P1S, A1, H2D, …) and the error code via Bambu's published HMS catalog. If Bambu's catalog has no entry for a code, the modal shows only the error description and the "Clear Errors" fallback.

Action labels are translated in all 11 supported locales (English, German, Spanish, French, Italian, Japanese, Korean, Portuguese (Brazil), Turkish, Simplified Chinese, Traditional Chinese).

Clear Errors¶

The HMS error modal also includes a Clear Errors button at the bottom that:

1. Sends a clean_print_error command to the printer via MQTT
2. Immediately removes errors from the Bambuddy UI
3. Only appears when there are active errors

This is useful for dismissing stale print_error values that persist after print cancellation or transient events (without needing to power-cycle the printer or start a new print). The per-error action buttons (above) handle the common cases — Clear Errors is the catch-all for older codes that have no action mapping.

WiFi Signal Strength¶

The printer card displays WiFi signal strength:

Weak signal can cause connection drops and print monitoring issues.

Total Print Hours¶

Track cumulative print time for each printer:

• Displayed on the printer card
• Useful for maintenance scheduling
• Helps identify heavily-used machines

MQTT Debug Logging¶

Built-in debugging tool for printer communication:

Starting Debug Logging¶

1. Click the settings icon on a printer card
2. Click Start MQTT Debug
3. Messages are captured in real-time

Viewing Messages¶

Features:

• JSON payloads - Expandable for detailed inspection
• Filter by type - Focus on specific message types
• Search - Find specific content
• Auto-refresh - New messages appear automatically

Use Cases¶

• Troubleshooting connection issues
• Understanding printer behavior
• Debugging automation problems
• Reporting issues to developers

WebSocket Architecture¶

Bambuddy uses WebSocket for real-time updates:

graph LR
    A[Printer] -->|MQTT| B[Bambuddy Backend]
    B -->|WebSocket| C[Browser]
    B -->|WebSocket| D[Browser 2]
    B -->|WebSocket| E[Mobile]

How It Works¶

1. Printer sends status updates via MQTT over TLS
2. Backend processes and stores the data
3. WebSocket broadcasts updates to all connected clients
4. Browser updates the UI instantly

Connection Features¶

Performance¶

• Latency: < 1 second typical
• Bandwidth: Minimal (delta updates only)
• Scalability: Multiple clients supported

Printer File Browser¶

Browse and manage files stored on your printer's internal storage.

Opening the File Browser¶

1. Click the folder icon () on any printer card
2. A modal opens showing the printer's file system

Navigation¶

• Quick access buttons - Jump to Root, Cache, Models, or Timelapse folders
• Breadcrumb path - Shows current location with back navigation
• Click folders - Navigate into subdirectories

File Selection¶

Select files for bulk operations:

File Operations¶

Sorting & Filtering¶

Storage Info¶

View used and free space in the header when available.

Printer Images¶

Customize your printer cards with images:

1. Click the settings icon on a printer card
2. Upload a printer image
3. The image displays on the card

Status Change Notifications¶

Configure alerts for printer events:

Set up notifications

Tips¶