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.

Bulk Actions¶

Select multiple printer cards and apply actions to all of them at once — ideal for print farms and multi-printer setups.

Entering Selection Mode¶

1. Click the Select button () in the printer page header toolbar
2. Printer cards now show checkboxes — click cards to select/deselect
3. A floating toolbar appears at the bottom of the screen

Selection Shortcuts¶

The floating toolbar provides quick ways to select printers:

When viewing printers grouped by location, each location header also shows a "Select All" link to select that group.

Available Bulk Actions¶

Each action button is smart-enabled — it only activates when at least one selected printer is in the appropriate state. For example, "Stop" is only clickable when a selected printer is printing or paused.

Permissions¶

• Stop, Pause, Resume, Clear Notifications require the Printer Control permission (printers:control)
• Clear Bed requires the Clear Plate permission (printers:clear_plate)

Exiting Selection Mode¶

• Press Escape on your keyboard
• Click the X button on the floating toolbar

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

Print Speed Control¶

Change print speed presets on-the-fly during active prints without leaving the printer card.

Speed Badge¶

A compact badge with a gauge icon appears in the controls row, next to the fan status badges. It displays the current speed percentage at a glance.

Speed Presets¶

Click the speed badge to open a dropdown menu with four presets:

How to Change Speed¶

1. Locate the speed badge ( with percentage) in the controls row during an active print
2. Click the badge to open the speed dropdown
3. Select a preset — the command is sent immediately via MQTT
4. The badge updates to reflect the new speed

Airduct Mode (P2S / X2D / H2*)¶

Switch the chamber airduct between Cooling and Heating modes from the printer card. Available only on P2S, X2D, H2D, H2C, and H2S — printers without an active airduct don't show the badge.

Airduct Badge¶

A compact badge appears in the controls row, immediately to the left of the print speed badge.

Click the badge to open a dropdown and pick the mode. The command is sent via MQTT (set_airduct) and the badge updates immediately on confirmation.

Move Build Plate (Z-Jog)¶

Move the build plate up or down directly from the printer card — useful for inspecting the plate through the camera after a print finishes, or for small manual positioning.

Bed-Jog Badge¶

A compact Bed badge appears in the controls row, between the print-speed badge and the Stop / Pause buttons. Click it to open a small popover containing:

• ↑ / ↓ buttons that move the plate by the selected step
• A step selector — 1 / 10 / 50 mm

The badge is automatically disabled while a print is running.

Not-Homed Warning (Studio-style)¶

After a print completes, the Z axis is usually no longer referenced. The first time you click up/down in a session, Bambuddy shows a warning modal matching the Bambu Studio / printer-touchscreen flow:

Permissions¶

Both the jog and home actions require printers:control. With authentication enabled, anonymous and read-only users see the buttons greyed out.

Under the Hood¶

The distance parameter is validated server-side to be non-zero and within ±200 mm.

SD Card & Door Status Badges¶

The top status row of every printer card now shows two compact icon-only badges so you can see drive and enclosure state at a glance.

Door state is detected from the right MQTT field per printer family (X1: home_flag bit 23, others: stat bit 23) and pushed live via WebSocket — no waiting for the next status poll.

Force Refresh¶

The printer card kebab menu has a Force Refresh entry that triggers an MQTT pushall request, asking the printer to re-broadcast its full status. Useful when a value looks stale and you don't want to fully reconnect (which would tear down the existing MQTT/FTP session).

Fan Status¶

Monitor cooling fan speeds in real time 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, shows current speed %
• Inactive (gray icon + text): Fan is off, shows 0%

: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¶