Real-time Monitoring

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

Printer Status

Each printer card displays real-time information:

Connection Status

• Green indicator: Connected and communicating
• Red indicator: Disconnected or connection error
• Yellow indicator: Connecting or reconnecting

Temperature Readouts

Sensor	Description
Nozzle	Current hotend temperature
Bed	Heated bed temperature
Chamber	Enclosure temperature (if available)

Print Progress

When a print is active:

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

---

HMS Error Monitoring

The Health Management System (HMS) monitors printer health:

Status Indicator

Always visible on printer cards:

• Green "OK": No issues detected
• Yellow: Minor issues or warnings
• Orange: Serious errors requiring attention
• Red: Fatal errors - stop printing

Error Severity Levels

Level	Color	Action Required
Info	Blue	Informational only
Common	Yellow	Check when convenient
Serious	Orange	Address before next print
Fatal	Red	Immediate attention needed

Error Details

Click the HMS indicator to see:

• Error code and description
• Affected component
• Recommended action
• Link to Bambu Lab support article

---

MQTT Debug Logging

Built-in debugging tool for printer communication:

Starting Debug Logging

1. Go to printer settings
2. Click "Start MQTT Debug"
3. Messages are captured in real-time

Viewing Messages

• Incoming: Messages from printer to Bambuddy
• Outgoing: Commands sent to printer
• JSON payloads: Expandable for detailed inspection
• Auto-refresh: New messages appear automatically

Use Cases

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

---

AMS (Automatic Material System)

For printers with AMS units:

Slot Status

• Filament color: Visual swatch for each slot
• Material type: PLA, PETG, ABS, etc.
• Remaining: Estimated filament left
• Temperature: Drying chamber temp (if applicable)

Humidity Monitoring

• Current humidity level in AMS
• Warning indicators for high humidity

---

Camera Feed

Access your printer's camera:

1. Click the camera icon on a printer card
2. View live camera feed
3. Take snapshots
4. Monitor print progress visually

Camera Page

Dedicated camera view with:

• Larger video display
• Multiple printer support
• Snapshot history

---

WebSocket Architecture

Bambuddy uses WebSocket for real-time updates:

Printer → MQTT → Bambuddy Backend → WebSocket → Browser

Connection Handling

• Automatic reconnection on disconnect
• State synchronization on reconnect
• Efficient delta updates (only changed data)

Performance

• Low latency updates (<1 second typical)
• Minimal bandwidth usage
• Multiple browser tabs supported

---

Notifications on Status Changes

Configure alerts for printer events:

• Printer Offline: When connection is lost
• Printer Error: When HMS errors occur
• Print Complete: When a job finishes
• Print Failed: When a print fails

See Push Notifications for setup details.

---

Tips

• Keep the Printers page open for at-a-glance monitoring
• Use the camera page for visual confirmation of print quality
• Enable HMS error notifications to catch problems early
• Check MQTT debug logs if a printer behaves unexpectedly