Print Archiving¶

Bambuddy automatically archives every completed print with full metadata, 3D previews, and duplicate detection.

How Archiving Works¶

When a print completes:

graph LR
    A[Print Completes] --> B[Download 3MF]
    B --> C[Extract Metadata]
    C --> D[Generate Thumbnail]
    D --> E[Check Duplicates]
    E --> F[Save to Archive]

What Gets Archived¶

What Gets Skipped¶

Bambuddy automatically skips archiving for:

• Calibration prints — Internal printer operations like flow rate calibration, vibration compensation, and bed leveling (gcode files under /usr/ on the printer)
• Prints with auto-archive disabled — Per-printer toggle in printer settings

3D Model Preview¶

View your models directly in the browser:

Three.js Viewer¶

• Rotate - Click and drag
• Zoom - Scroll wheel
• Pan - Right-click and drag
• Reset - Double-click

Viewer Features¶

• Wireframe mode
• Solid/transparent modes
• Color from slicer
• Multi-part support

Plate Selector¶

For multi-plate 3MF files, the viewer includes a plate selector panel:

• Thumbnail Grid - Visual preview of each plate
• Object Count - Shows how many objects are on each plate
• "All Plates" Option - View all plates combined (default)
• Individual Selection - Click a plate to view just that plate's objects

Fullscreen Mode¶

Click the fullscreen button in the modal header for an immersive viewing experience:

• Resizable Split View - Drag the divider between the plate panel and 3D viewer
• Pagination - For files with many plates, pagination controls appear automatically
• Responsive Layout - Plate grid adjusts columns based on available width

Object Count Display¶

The header shows the total object count across all plates, or the count for the selected plate:

• All Plates: Shows total objects (e.g., "All Plates: 15 objects")
• Single Plate Selected: Shows that plate's count (e.g., "Plate 1: 5 objects")

Duplicate Detection¶

Bambuddy automatically detects duplicate prints:

How It Works¶

1. Extracts file hash from 3MF
2. Compares with existing archives
3. Marks potential duplicates
4. You decide what to keep

Duplicate Indicators¶

• Badge showing "Duplicate"
• Link to original print
• Side-by-side comparison available

Managing Duplicates¶

• Keep both - Sometimes you intentionally reprint
• Delete duplicate - Remove the newer one
• Merge - Combine statistics from both

Archive Cards¶

Each archive displays as a card with key information:

┌────────────────────────────────────────┐
│  [Thumbnail]                           │
│                                        │
│  Benchy.3mf                           │
│  Workshop X1C • 2h 15m                │
│  ✓ Success • 45g PLA                  │
│                                        │
│  [Tags] [Project Badge]               │
└────────────────────────────────────────┘

Card Information¶

• Thumbnail - Visual preview
• Filename - Original file name
• Printer - Which printer completed it
• Duration - How long it took
• Result - Success, failed, or stopped
• Filament - Material and weight used
• Object Count - Number of printable objects in the 3MF
• Tags - Custom labels
• Project - Assigned project badge
• Uploaded by - Username who uploaded (when authentication is enabled)

Card Action Buttons¶

Each archive card has action buttons at the bottom for quick access:

Context Menu Button¶

Each card has a three-dot menu button (⋮) that appears on hover:

• Provides quick access to all context menu actions
• Always visible on mobile devices
• Located on the left side of the card

Multi-Plate Browsing¶

For archives created from multi-plate 3MF files, you can browse through each plate's thumbnail directly on the card:

1. Hover over the archive card to reveal navigation controls
2. Arrow buttons (◀ ▶) on left/right to cycle through plates
3. Dot indicators at bottom show current plate (clickable)
4. Each plate shows its individual thumbnail preview

View Modes¶

Switch between different archive views using the toolbar buttons:

Grid View (Cards)¶

Default view showing archive cards in a responsive grid:

• Large thumbnails for visual browsing
• All metadata visible at a glance
• Best for visual identification

List View¶

Compact table view for data-focused browsing:

• One archive per row
• Sortable columns
• Inline edit and delete buttons
• Three-dot menu for full context menu access
• Best for managing large archives

Calendar View¶

Browse archives by date:

• Monthly calendar layout
• Dots indicate prints on each day
• Color coding for success/failure
• Click a day to see that day's prints
• Click an archive to highlight it in grid view

Cross-View Highlighting¶

Click an archive in calendar view or from a project's archive list:

1. Switches to grid view automatically
2. Scrolls to the selected archive
3. Highlights with a yellow border for 5 seconds
4. Great for finding specific prints across views

Context Menu Actions¶

Right-click (or long-press on mobile) for quick actions:

Re-print with AMS Mapping¶

When re-printing an archive, Bambuddy shows a filament comparison with auto-matching and manual override options:

What It Shows¶

Status Indicators¶

Features¶

• Auto-Matching - Automatically finds the best AMS slot for each required filament (type + color)
• Manual Slot Selection - Click the dropdown to override auto-matching and select any AMS slot
• Color Names - Dropdown shows color names (decoded from Bambu filament codes like "Jade White", "Cobalt Blue", or derived from hex for third-party filaments)
• Blue Ring Indicator - Shows which slots have been manually selected vs auto-matched
• AMS Slot Labels - Shows which AMS unit and slot contains the filament (e.g., "AMS-B Slot 3")
• Fuzzy Color Matching - Colors are matched within a tolerance, so slight hex variations still show as a match
• Re-read Button - Refresh AMS status from the printer if you've swapped spools since the modal opened

Multi-Plate 3MF Files¶

When reprinting a multi-plate 3MF file (exported from Bambu Studio with "All sliced file"), Bambuddy shows a plate selection grid:

• Plate Thumbnails - Visual preview of each plate to help identify the correct one
• Plate Names - Shows object names and print time estimates
• Filtered Filaments - Only filaments used by the selected plate are shown for mapping
• Required Selection - You must select a plate before printing

This prevents the issue where all plates' filaments were shown together, causing incorrect AMS mapping.

Print Options¶

Click Print Options to configure settings before starting:

How It Works¶

1. Click Re-print on an archive
2. Select target printer
3. For multi-plate files: Select which plate to print from the grid
4. Review filament comparison (click Re-read if you've changed spools)
5. Expand Print Options to adjust settings if needed
6. Click Print to start

Photo Attachments¶

Add photos to your archives:

Camera Snapshot¶

Automatic camera capture on print completion:

1. Go to Settings > General
2. Enable Capture snapshot on print complete
3. Photos are automatically added to archives

Manual Photos¶

Upload photos of your finished prints:

1. Open an archive
2. Click Add Photo
3. Upload from your device
4. Photos are stored with the archive

Timelapse Editor¶

Edit your timelapse videos directly in Bambuddy:

Opening the Editor¶

1. Open an archive with a timelapse
2. Click the timelapse to view it
3. Click Edit in the viewer header

Editor Features¶

Timeline Controls¶

• Thumbnail strip - Visual preview of video frames
• Trim handles - Drag to set start/end points
• Playhead - Shows current position
• Play/Pause - Preview trimmed section

Adding Music¶

1. Click the Music section
2. Upload an audio file (MP3, WAV, M4A, AAC, OGG)
3. Adjust volume with the slider
4. Preview synced with video playback

Saving Changes¶

Click Save to process the video. The original timelapse will be replaced with the edited version.

Source 3MF Upload¶

Upload the original 3MF file for prints started outside Bambuddy:

1. Open an archive
2. Click Upload 3MF
3. Select the source file
4. 3MF is stored with the archive

This enables 3D preview and re-printing even for imported archives.

Fusion 360 Design Files¶

Attach F3D design files to archives for complete design tracking:

Uploading F3D Files¶

1. Right-click an archive (or use the context menu button)
2. Select Upload F3D
3. Choose your .f3d file
4. File is stored with the archive

F3D Badge¶

Archives with attached F3D files show a cyan badge on the card (next to the source 3MF badge if present). Click the badge to download the file.

Context Menu Options¶

Tags¶

Organize archives with custom tags:

Creating Tags¶

1. Open any archive
2. Click Edit Tags
3. Type a new tag name
4. Press Enter to create

Using Tags¶

• Filter archives by tag
• Combine multiple tags
• Color-coded in the interface

Tag Examples¶

• functional - Useful prints
• decoration - Decorative items
• gift - Prints for others
• prototype - Test iterations
• failed - Print failures

Tag Management¶

Manage all tags from a centralized location:

1. Navigate to Archives page
2. Click the gear icon next to the tag filter dropdown
3. View all tags with usage counts

Available actions:

Notes¶

Add notes to archives:

• Design changes
• Print settings tweaks
• Quality observations
• Reference links

Notes are searchable via full-text search.

Designer Attribution¶

Credit the model designer:

1. Open an archive
2. Click Edit Details
3. Add Designer name
4. Optionally add Designer URL

Great for tracking models from Printables, Thingiverse, etc.

External Links¶

Link archives to their source on Printables, Thingiverse, or other sites:

Adding an External Link¶

1. Open an archive
2. Click Edit (pencil icon)
3. Enter the URL in the External Link field
4. Click Save

How It Works¶

Filtering Archives¶

Find archives quickly:

Filter Options¶

Combining Filters¶

Stack multiple filters to narrow results. For example: "PLA prints from Workshop X1C in the last week."

Sorting¶

Sort archives by:

• Date (newest/oldest)
• Name (A-Z/Z-A)
• Duration (shortest/longest)
• Printer (grouped)

Tips¶