Real-time Monitoring¶

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

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:

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%

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

Print Progress¶

When a print is active, you'll see:

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

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

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¶