Projects¶

Group related prints into projects to track multi-part builds, gift sets, or any collection of related prints.

What Are Projects?¶

Projects let you:

• Group prints - Organize related archives together
• Track progress - See completion status
• Set targets - Define how many items needed
• Track quantities - Count items per print for batch printing
• Bill of materials - Track sourced parts (screws, electronics)
• File attachments - Store documentation and references
• Cost tracking - Budget and expense tracking
• Color code - Visual identification
• Add notes - Document the project

Use Cases¶

Creating a Project¶

1. Go to the Projects page
2. Click New Project
3. Fill in the details:

1. Click Create

Adding Archives to Projects¶

From Archive Card¶

1. Right-click an archive card
2. Select Add to Project
3. Choose the project
4. Archive is linked

From Archive Details¶

1. Open an archive
2. Click the Project dropdown
3. Select a project
4. Changes save automatically

Bulk Assignment¶

Assign multiple archives at once using the multi-select toolbar:

1. Click Select button (or Shift+click / Ctrl+click archives)
2. Select the archives you want to assign
3. Click the Project button in the bottom toolbar
4. Choose a project from the list
5. All selected archives are assigned instantly

Progress Tracking¶

Track how close you are to completing a project with separate progress for plates and parts:

Dual Progress Bars¶

When you set both target plates and target parts, you'll see two progress bars:

Plates Progress
[████████░░░░░░░░░░░░] 40%
2 of 5 print jobs

Parts Progress
[████████░░░░░░░░░░░░] 40%
10 of 25 parts

Progress States¶

Plates Progress¶

Tracks the number of print jobs completed:

• Plates Target: 5 with 2 prints done = 40%
• Based on archive count (not quantities)

Parts Progress¶

Tracks the total number of parts/objects printed:

• Parts Target: 25 with 10 parts printed = 40%
• Sum of all archive quantities

Auto-Detection from 3MF¶

When a print is archived, BamBuddy automatically detects how many parts/objects were on the plate:

• Reads slice_info.config from the 3MF file
• Counts non-skipped objects
• Sets the archive quantity automatically

Manual Quantity Override¶

You can still manually adjust the quantity:

1. Open the archive in edit mode
2. Set Items Printed to the correct number
3. Project progress updates automatically

Updating Existing Archives¶

If you have existing archives with quantity=1, run the migration script:

# Preview changes
python scripts/update_archive_quantities.py --dry-run

# Apply changes
python scripts/update_archive_quantities.py

This re-parses all 3MF files to extract the correct object counts.

Color Coding¶

Each project has a color-coded badge:

Available Colors¶

• Red
• Orange
• Yellow
• Green
• Blue
• Purple
• Gray

Badge Display¶

Project badges appear on:

• Archive cards
• Archive list view
• Project overview

Project Cards¶

Each project displays as a card with plates and parts stats:

┌────────────────────────────────────────┐
│  [Color] Voron Build          150/200  │
│                                parts   │
│  Building a Voron 2.4r2 printer       │
│                                        │
│  Plates [████████░░░░] 40%            │
│  20/50 print jobs                      │
│                                        │
│  Parts  [████████████░░░] 75%         │
│  150/200 parts                         │
│                                        │
│  📦 20 plates  🎯 150 parts            │
└────────────────────────────────────────┘

Card Information¶

• Color badge - Visual identification
• Name - Project title
• Progress badge - Parts completed / target
• Plates progress - Print jobs completed
• Parts progress - Objects printed
• Stats footer - Quick view of plates and parts count

Editing Projects¶

1. Click the edit icon on a project card
2. Modify any field
3. Click Save

Editable Fields¶

• Name
• Description
• Color
• Target Plates (print jobs)
• Target Parts (objects)

Filtering by Project¶

Filter archives to show only those in a project:

1. Go to Archives page
2. Click the Project filter
3. Select a project
4. Only linked archives are shown

Deleting Projects¶

Deleting a project:

1. Click the delete icon on a project card
2. Confirm deletion

Import & Export¶

Share projects between Bambuddy instances or backup your project data.

Exporting a Single Project (ZIP)¶

Export a complete project bundle including all files from linked library folders:

1. Open the project detail page
2. Click the Export button
3. A ZIP file is downloaded containing:
4. project.json - Project settings, BOM items, and folder metadata
5. files/ - All files from linked library folders

Exporting All Projects (JSON)¶

Export all projects as metadata only (no files):

1. Go to the Projects page
2. Click the Export button in the header
3. A JSON file is downloaded with all project metadata

Importing Projects¶

Import projects from ZIP or JSON files:

1. Go to the Projects page
2. Click the Import button
3. Select a .zip or .json file

ZIP Import:

• Creates the project with all settings
• Creates linked library folders
• Extracts and stores all files from the ZIP
• Files are available in File Manager

JSON Import:

• Creates the project with all settings
• Creates empty linked folders (names only)
• Supports single project or batch import (array of projects)

Project Archives View¶

Click a project card to see all its archives:

• Grid view of all linked prints
• Same filtering and sorting as main Archives
• Quick access to add more prints

Bill of Materials¶

Track non-printed parts needed for your project (screws, electronics, hardware):

Adding BOM Items¶

1. Open a project
2. Scroll to Bill of Materials
3. Click Add Item
4. Fill in the details:

Tracking Acquisition¶

• Check the box when a part is acquired
• Progress bar shows acquired/total items
• Use Hide done to focus on remaining items

File Attachments¶

Attach reference files to your project:

Supported File Types¶

Uploading Files¶

1. Open a project
2. Scroll to Attachments
3. Click Upload or drag and drop
4. Files are stored with the project

Cost Tracking¶

Track project expenses:

Cost Categories¶

• Parts cost - Sum of BOM item prices
• Additional costs - Manual entries for other expenses

Currency¶

Uses your configured currency from Settings → General.

Project Ideas¶