Print Queue¶

Queue and schedule prints with drag-and-drop ordering, timed starts, and smart plug automation.

Queue Overview¶

The print queue lets you:

• Queue prints from your archive
• Order with drag-and-drop
• Schedule specific start times
• Automate with smart plug integration
• Track queue progress

Adding to Queue¶

From Archive¶

1. Go to Archives page
2. Click the Schedule button on the archive card (or right-click and select Schedule)
3. Choose target printer
4. Optionally configure filament mapping (see below)
5. Print is added to queue

From File Manager¶

1. Go to File Manager page
2. Select sliced files (.gcode or .gcode.3mf)
3. Click Add to Queue in toolbar (or right-click context menu)
4. Choose target printer (or leave unassigned)
5. Files are archived and queued automatically

From Queue Page¶

1. Go to Queue page
2. Click Add Print
3. Browse and select an archive
4. Choose target printer
5. Optionally set schedule time
6. Optionally configure filament mapping

AMS Filament Mapping¶

When adding multi-color prints to the queue, you can configure which AMS slot to use for each filament:

1. Expand the Filament Mapping section
2. View auto-matched filaments (type + color)
3. Click any dropdown to manually select a different AMS slot
4. Color names shown for easy identification (decoded from Bambu filament codes)
5. Mapping is stored with the queued print

Dual-Nozzle Printers (H2D/H2D Pro):

On dual-nozzle printers, filament matching is nozzle-aware. Each filament requirement shows an L or R badge indicating which nozzle it targets. Auto-matching only considers AMS trays connected to the correct nozzle via ams_extruder_map. This prevents sending filament meant for the left nozzle to the right one and vice versa.

Plate Selection (Multi-Plate 3MF)¶

For 3MF files with multiple plates:

1. Click Edit on a queued item
2. Scroll to Plate Selection section
3. Browse plates with thumbnails and print times
4. Click to select the plate to print
5. Filament requirements update to show selected plate's filaments

Print Options¶

Configure printer settings for each queued print:

1. Click Edit on a queued item
2. Expand Print Options section
3. Toggle options as needed:

Drag and Drop Ordering¶

Reorder prints in the queue:

1. Hover over a queued print
2. Grab the drag handle
3. Drag to new position
4. Release to reorder

Prints execute in order from top to bottom.

Scheduling¶

Immediate Prints¶

Add to queue without a schedule - prints start when:

• Printer is idle
• Previous prints complete
• No scheduled prints are pending

Scheduled Prints¶

Set a specific start time:

1. Click Schedule on queued print
2. Choose date and time
3. Print starts at scheduled time

Schedule Priority¶

Scheduled prints take priority:

1. Check for scheduled prints at scheduled time
2. If none, check immediate queue
3. Start next print

Queue Only (Staged Prints)¶

Stage prints without automatic scheduling:

1. When adding to queue, select Queue Only
2. Print shows with purple Staged badge
3. Print won't start automatically
4. Click Play button to release to queue

Use Queue Only to:

• Prepare print batches before activating
• Stage prints across multiple printers
• Review and approve before printing starts
• Build a queue without immediate execution

Smart Plug Automation¶

Combine with smart plugs for full automation:

Auto Power On¶

When a queued print is ready:

1. Bambuddy checks if printer is on
2. If off and smart plug configured, powers on
3. Waits for printer to boot
4. Starts the print

Auto Power Off¶

After print completes:

1. Print completes
2. Cooldown period (configurable)
3. Check if more prints queued
4. If no more prints, power off

Configuration¶

1. Go to Settings > Smart Plugs
2. Configure plug for printer
3. Enable Auto Power On and Auto Power Off
4. Set cooldown temperature and time

Smart Plugs setup

Queue Status¶

Print States¶

Queue Card¶

Each queued print shows:

• Thumbnail (shows the selected plate's thumbnail for multi-plate files)
• Print name
• Target printer
• Estimated duration
• Scheduled time (if set)
• Status
• Added by (username who queued the print, when authentication is enabled)

Managing Queue¶

Remove from Queue¶

1. Click the X on any queued print
2. Confirm removal
3. Print is removed (not deleted from archive)

Cancel Running Print¶

1. Find the currently printing item
2. Click Cancel
3. Print stops on printer
4. Marked as cancelled in queue

Clear Plate Confirmation¶

When a print finishes or fails and more items are queued for the same printer, the next print does not start automatically. Instead, the printer card shows a "Clear Plate & Start Next" button.

1. Remove the finished print from the build plate
2. Click Clear Plate & Start Next on the printer card
3. The scheduler starts the next queued print within 30 seconds

This prevents prints from starting on a dirty plate. The button appears whenever the printer is in Finished or Failed state with pending queue items.

Clear Queue¶

Remove all queued prints:

1. Click Clear Queue button
2. Confirm action
3. All pending prints removed

Bulk Editing¶

Edit multiple queued items at once:

Selecting Items¶

1. Look for checkboxes on pending queue items
2. Click checkbox to select/deselect individual items
3. Use Select All / Deselect All in the toolbar

Bulk Edit Modal¶

When items are selected, click Edit Selected to open the bulk edit modal:

Tri-State Toggles¶

Each setting has three states:

Only settings you explicitly change are applied - other settings remain as they were.

Bulk Cancel¶

Click Cancel Selected to cancel all selected pending items at once.

Multi-Printer Queue¶

Queue prints across multiple printers:

Per-Printer Queues¶

Each printer has its own queue:

• Filter by printer to see specific queue
• Prints wait for their assigned printer
• Different printers can print simultaneously

Multi-Printer Selection¶

Send the same print to multiple printers at once:

1. Open Add to Queue or Re-print modal
2. Select multiple printers using checkboxes
3. Use Select all / Clear buttons for quick selection
4. Configure filament mapping (default applies to all printers, or use per-printer mapping)
5. Click submit to send to all printers

Per-Printer AMS Mapping¶

When multiple printers are selected, you can configure filament slot mapping individually for each printer:

1. Select multiple printers
2. Under each printer, check Custom mapping to enable per-printer configuration
3. The mapping section expands showing:
4. Required filaments with color indicators
5. Dropdown to select AMS slot for each requirement
6. Match status: exact, type-only, missing
7. Click Auto to auto-configure using RFID data
8. Click Re-read to refresh the printer's loaded filaments

Choosing a Printer¶

When adding to queue:

1. Select one or more target printers
2. Prints join each printer's queue
3. Different archives can go to different printers

Load Balancing¶

Manually distribute prints:

• Add long prints to less-used printers
• Queue time-sensitive prints on fastest printer
• Keep specific materials on specific printers
• Use multi-printer selection for batch production

Model-Based Queue Assignment¶

Queue prints to "any printer of matching model" for automatic load balancing across identical printers.

How It Works¶

1. When you add a print to the queue, select Any [Model] instead of a specific printer
2. Optionally select a Location to further filter available printers (e.g., "Any X1C in Workshop")
3. Bambuddy extracts the printer model from the sliced 3MF file (e.g., "X1C", "P1S")
4. The scheduler automatically assigns the print to the first idle printer of that model (and location, if specified)
5. If filament validation is enabled, it only assigns to printers with the required filaments loaded

Adding Model-Based Queue Items¶

1. Open Add to Queue modal
2. In the printer selection, choose Any X1C, Any P1S, etc.
3. Optionally select a Location from the dropdown to filter by printer location
4. Configure other options as usual
5. Submit - the print joins the queue without a specific printer

Location Filtering¶

When you have multiple printers of the same model in different locations:

1. Choose Any [Model] for the printer
2. Select a Location from the dropdown (shows all locations from your printers)
3. The scheduler only considers printers at that location
4. Queue items show the target location (e.g., "Any X1C - Workshop")

Filament Validation¶

When a model-based queue item has required filaments:

1. Scheduler checks each printer of the matching model
2. Only printers with all required filament types loaded (in AMS or external spool) are considered
3. Jobs wait until a compatible printer becomes available
4. The Waiting status (purple badge) shows why a job is waiting

Waiting Status¶

Model-based queue items show detailed status:

The waiting reason tells you exactly what's needed:

• Waiting for filament: Which printers are missing which filament types
• Busy: Which printers are currently printing
• Offline: Which printers are disconnected

Compatibility Warnings¶

When queuing to a specific printer that doesn't match the sliced model:

• A warning shows "File was sliced for X1C, but printing on P1S"
• This helps avoid issues from mismatched print profiles

Queue Notifications¶

Get notified about queue events. Configure these in Settings → Notifications under "Print Queue":

Set up notifications

Queue History¶

View past queue activity:

• Completed prints
• Failed prints
• Cancelled prints
• Execution times

History helps you:

• Track throughput
• Identify patterns
• Debug issues

API Access¶

Manage queue programmatically:

# Add to queue
POST /api/v1/queue

# Get queue status
GET /api/v1/queue

# Remove from queue
DELETE /api/v1/queue/{id}

See API Reference for details.

Tips¶