Printer Control¶

Bambuddy provides control over various printer settings and features directly from the web interface.

Print from Printer Card¶

Start prints directly from any printer card — no need to navigate to File Manager first.

Print Button¶

A green Print button appears on each printer card when the printer is idle:

1. Click the Print button at the bottom of the printer card
2. A file upload modal opens — select a .gcode or .gcode.3mf file
3. The file is automatically uploaded to your library
4. The Print Modal opens with the printer pre-selected
5. Configure filament mapping and print options, then click Print

The printer selector is hidden since the target printer is already known.

Drag & Drop¶

Drag a sliced file directly onto any printer card to start printing:

1. Drag a .gcode or .gcode.3mf file from your computer onto a printer card
2. A green "Drop to print" overlay appears (or red "Printer busy" if unavailable)
3. Drop the file — it uploads to your library automatically
4. The Print Modal opens with the printer pre-selected
5. Configure and print

Printer Compatibility Check¶

Both flows automatically check if the file was sliced for a compatible printer model. If the file's sliced_for_model metadata doesn't match the target printer, you'll see an error and the file is removed from the library.

Printer Information¶

View detailed printer information from the three-dot menu on any printer card.

Click Printer Information to see:

Print Job Controls¶

Control active print jobs directly from the printer card:

Stop Print¶

Cancel the current print job:

1. Locate the Stop button () on the printer card during printing
2. Click to stop the print
3. Confirm in the modal dialog
4. Print is cancelled and printer returns to idle

Pause / Resume¶

Temporarily pause and resume printing:

To pause/resume:

1. Click the Pause button during an active print
2. Confirm in the modal dialog
3. Printer pauses and displays "Paused" status
4. Click Resume to continue printing

Clear HMS Errors¶

Dismiss stale HMS errors directly from the HMS error modal:

1. Click the HMS indicator on the printer card to open the error modal
2. Review the listed errors
3. Click Clear Errors to dismiss them

The clear command sends clean_print_error via MQTT and immediately removes errors from the UI. This is useful after print cancellation or transient events that leave print_error values behind.

Clear Plate¶

When a print finishes or fails and there are queued prints waiting, a "Clear Plate & Start Next" button appears on the printer card. Clicking it confirms that the build plate has been cleared, allowing the queue scheduler to start the next print.

Confirmation Modals¶

All print control actions require confirmation to prevent accidental clicks:

• Stop: "Are you sure you want to stop this print?"
• Pause: "Are you sure you want to pause this print?"
• Resume: "Are you sure you want to resume this print?"

Toast notifications provide feedback after each action.

Skip Objects¶

Skip individual objects during a print without stopping the entire job.

How It Works¶

When a print starts, Bambuddy extracts object information from the 3MF file. You can then skip any object that's failing or that you no longer need.

Using Skip Objects¶

1. Click the Skip button (top-right of printer card) during printing
2. A modal appears showing:
3. Preview image with object ID markers overlaid in a grid
4. Object list with large ID badges and names
5. Info banner explaining to match IDs with your printer's display
6. Click Skip next to any object you want to exclude
7. The object will be marked as skipped and won't be printed

Skip Objects Modal¶

Object Display¶

Layer Requirement¶

Requirements¶

For skip objects to work properly:

1. Enable Exclude Objects in your slicer (Bambu Studio / OrcaSlicer)
2. Go to Other → Exclude objects
3. This ensures each object gets a unique ID
4. Objects must be properly separated in the slicer
5. Clone/array objects may share IDs unless exclude is enabled
6. Print must have 2 or more objects

Chamber Control¶

For enclosed printers (X1 series, H2 series), control the chamber environment:

Chamber Temperature¶

• View current chamber temperature
• Set target temperature (if supported)
• Monitor heating/cooling status

Chamber Light¶

Toggle the internal chamber LED directly from the printer card.

Location: Light button next to the camera button at the bottom of the printer card.

To toggle:

1. Click the light button at the bottom of the printer card
2. Light state changes immediately (optimistic update)
3. Toast notification confirms the change

Fan Controls¶

Monitor and adjust cooling fans directly from the printer card.

Real-Time Fan Status¶

The Controls section displays compact fan badges showing real-time speeds:

Badges are always visible with dynamic coloring:

• Active (colored icon + text): Fan is running
• Inactive (gray icon + text): Fan is off, shows 0%

Part Cooling Fan¶

• View current speed (%)
• Adjust during print if needed
• Auto-controlled by slicer normally

Auxiliary Fan¶

• Controls airflow in the chamber
• Helps with certain materials
• Can be adjusted manually

Chamber Fan¶

• Exhausts hot air from enclosure
• Important for high-temp printing
• Auto-controlled based on chamber temp

:material-nozzle: Dual Nozzle Support¶

For dual-nozzle printers (H2D, etc.):

Nozzle Status¶

View both nozzles:

• Current temperature
• Target temperature
• Heating status

Nozzle Selection¶

See which nozzle is active during printing.

Power Controls¶

Control printer power state:

Power Switch¶

If a smart plug is configured:

• Power On - Turn printer on
• Power Off - Turn printer off
• Status - View current power state

Smart plug setup

Auto Power Off¶

Configure automatic shutdown:

1. Enable Auto Power Off in settings
2. Set Cooldown Temperature threshold
3. Set Cooldown Time delay
4. Printer powers off after print completes and cools

Print Settings Override¶

During an active print, you can adjust:

Tips¶