Printer Control¶

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

Print from Printer Card¶

Start prints 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, print options, and dispatch option, then click Print

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

Dispatch options control where the new queue item is placed:

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 filament mapping, print options, and dispatch option, then 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

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

Each error in the HMS modal shows the same action buttons BambuStudio and Bambu Handy display — Resume Printing, Stop Printing, Continue, Retry, Filament Extruded, Check Assistant, Don't Remind Me, and so on. Click any button and Bambuddy sends the matching MQTT command back to the printer, so you can clear a paused-print dialog from your phone instead of walking to the device.

1. Click the HMS indicator on the printer card to open the error modal
2. Review the listed errors and their action buttons
3. Click the action you want — Bambuddy sends the matching command and the modal closes

Which buttons appear depends on your printer model and the specific error code, mapped against Bambu's published HMS catalog. Action labels are translated in all 11 supported locales.

For the full details on which commands each action sends (resume / idle_ignore type=0 vs type=1 / ams_control / etc.), see HMS Error Monitoring → Error Actions.

Clear HMS Errors¶

The HMS modal also includes a Clear Errors button at the bottom for codes that don't have specific actions or for dismissing stale errors after a print cancellation:

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 on models with an active chamber heater (H2C, H2D, H2D Pro, H2S, X2D) — see Temperature Setpoints below
• 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

Temperature Setpoints¶

Click any temperature card on the printer card (Nozzle / Bed / Chamber) to open a popover with quick-select buttons plus a custom-value input. Sending the setpoint is optimistic — the popover closes immediately and the toast confirms the printer accepted the command.

Nozzle Temperature¶

On dual-nozzle printers (H2D), the temperature card opens a wider popover with separate Left Temp and Right Temp panels — set each nozzle independently. The L/R selector for switching the active extruder remains on the nozzle card next to it (POST /printers/{id}/select-extruder).

Bed Temperature¶

Chamber Temperature (heated-chamber models only)¶

Setting a chamber target via M141 is only supported on printers with an active chamber heater: H2C, H2D, H2D Pro, H2S, X2D. Sensor-only models (X1C, X1E, P2S, H2C plain variants) still show the chamber reading but the temperature card is read-only there — the route 400s before sending the G-code to avoid a silent no-op at the firmware level.

Customizable Presets¶

The three quick-select values per temperature category (and per fan category — see Fan Speed Control below) are user-configurable under Settings → Workflow → Temperature & Fan Presets. The fixed "Off" button is always shown and is not part of the configurable triple. Empty stored value falls back to the built-in defaults shown above.

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.

Jog Controls¶

Move the build plate, toolhead, or extruder directly from the printer card — useful for inspecting the plate through the camera after a print finishes, manually positioning the toolhead before loading filament, or purging the nozzle.

The jog popover groups all three axes: Z (build plate), XY (toolhead), and E (extruder). The popover is disabled entirely while a print is running.

Z-Jog (Build Plate)¶

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:

XY-Jog (Toolhead)¶

Move the toolhead by a signed relative X/Y distance per click. Distinct from Z-Jog because the XY plane has no soft-endstop convention to "ignore" — the firmware enforces print volume bounds, but Bambuddy clamps the request server-side as a first guard.

Omitted axes are dropped from the G-code — passing only x jogs X-only, etc.

Extruder Jog¶

Manually extrude or retract filament. Positive distance extrudes, negative retracts. Use this to purge before a colour change or test that filament is loaded into the hotend.

Permissions¶

All 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: Z and XY are bounded to ±200 mm, extruder to ±100 mm. All three reject 0.

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).

Maintenance Mode¶

Take a printer out of service without removing it. Toggling Maintenance Mode tells Bambuddy to disconnect MQTT for that printer and stop including it in queue dispatch, the scheduler, model-based filament lookups, metrics, scheduled backups, and notification events. The printer card stays visible on the dashboard with an amber wrench banner and an Exit button, so the printer never disappears from your mental map — and you can flip it back in one click when the work is done.

When to use it¶

• Parallel Bambuddy installs sharing the same hardware. A Bambu printer only accepts one MQTT client at a time; if you run a dev install and a prod install pointing at the same printer, the second connection flickers online/offline burning CPU and bandwidth. Put the printer in Maintenance Mode on the install that isn't actively driving it.
• Under repair or awaiting parts. Keep the card on the dashboard so the printer isn't forgotten, but make sure it can't pick up queued jobs while it's mid-disassembly.
• Temporary suspension while you do hardware work, network changes, or anything else that would make scheduled prints fail.

How to toggle it¶

Three entry points, all wired to the same backend flag:

1. Printer card three-dot menu → Enter / Exit maintenance mode (wrench icon). One click, no dialog when the printer is idle.
2. Exit button in the in-card amber banner — visible whenever the printer is in Maintenance Mode.
3. Edit Printer dialog → Maintenance mode checkbox.

If you try to enter Maintenance Mode while a print is in progress (RUNNING / PAUSE), Bambuddy shows a confirmation dialog before flipping the switch — disconnecting MQTT mid-print stops progress tracking and completion notifications for that job, which is almost never what you actually want. Idle / FINISH / FAILED states skip the dialog and toggle directly.

What happens behind the scenes¶

Maintenance Mode vs. the Maintenance dashboard¶

These two share a name but solve different problems:

• Maintenance Mode (this section) — a per-printer on/off state for "is this printer currently in service?" Flip when you start a repair, flip back when it's done.
• Maintenance dashboard (/maintenance) — interval-tracked scheduled tasks like clean carbon rods every 50 hours, lubricate linear rails monthly, replace nozzle every 1000 hours. See Maintenance Tracking for the dashboard.

In practice they pair well: when you start a real maintenance task from the dashboard, flipping Maintenance Mode on the same printer keeps the queue from sending it work while you have the cover open.

Fan Speed Control¶

Monitor and control 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%

Setting Fan Speeds¶

Click any fan badge to open a popover with quick-select buttons (Off + three user-configurable presets) plus a custom value input.

The optimistic UI update applies the new speed to the badge immediately; an error toast plus revert fires if the printer rejects the command.

Customizable presets per fan category live under Settings → Workflow → Temperature & Fan Presets.

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