Spool Inventory¶

Bambuddy includes a built-in spool inventory system to track your filament collection, assign spools to AMS slots, and automatically monitor filament consumption.

Inventory Overview¶

The Spool Inventory page shows all your spools in a searchable, filterable table with summary statistics.

Summary Cards¶

Filtering & Search¶

• Status tabs: Active, Archived, All
• Quick filters: Used, New
• Stock filter: All, Stock (no slicer profile), Configured (has slicer profile)
• Dropdowns: Filter by Material, Brand
• Search: Find spools by name, brand, material, or color
• View modes: Table or Cards
• Group similar: Toggle to visually collapse identical unused/unassigned spools into a single expandable row or card with a count badge (e.g., "5 identical spools"). Spools are grouped by material, subtype, brand, color, and label weight. Used or AMS-assigned spools always appear individually. Group state persists across sessions.

Adding Spools¶

Click + Add Spool to create a new inventory entry.

Filament Info Tab¶

Quick Add (Stock Spools)¶

Toggle Quick Add (Stock) at the top of the spool form to switch to a simplified mode. This hides the slicer preset and the PA Profile tab — only Material (required), Brand, Subtype (both optional), Label Weight, Quantity, and Color are shown.

Use Quick Add when you want to inventory filament without picking a specific slicer profile. These are called "stock" spools — they track weight and usage like any other spool, but they aren't linked to a printer filament profile. You can always edit a stock spool later to assign a slicer preset, at which point it becomes a "configured" spool.

Where Presets Come From¶

The Slicer Preset dropdown merges filament profiles from three sources, checked in order:

Presets from all three sources are merged and deduplicated. If cloud login fails, local + built-in presets still appear — the preset list is never empty.

Custom Materials¶

The material dropdown includes common types: PLA, PETG, ABS, TPU, ASA, PC, PA, PVA, HIPS, PA-CF, PETG-CF, and PLA-CF.

If your material isn't listed (e.g., PCTG, PHA, PP, PVDF), simply type it into the Material field. A "Use custom material" option will appear at the bottom of the dropdown — click it to use your custom material type.

Custom materials work just like built-in ones for inventory tracking, usage history, and filtering.

Additional Section¶

PA Profile Tab¶

Link pressure advance (K-factor) calibration profiles to the spool:

• Auto-select matches profiles by brand, material, and subtype
• Shows matches grouped by printer and nozzle (left/right for dual-nozzle)
• K-factor values displayed for quick reference

AMS Slot Assignment¶

Assign inventory spools to AMS slots to track which filament is loaded where.

Assigning a Spool¶

1. Hover over any AMS slot on the printer card (empty or configured, non-Bambu-Lab)
2. Click Assign Spool in the hover card

1. Select a spool from the filtered list
2. Click Assign Spool to confirm

The assign modal automatically:

• Filters out Bambu Lab spools — these are tracked via RFID and managed by the AMS
• Filters out already-assigned spools — each spool can only be in one slot at a time
• Shows only manually added (non-BL) spools

Unassigning a Spool¶

1. Hover over an assigned AMS slot
2. Click Unassign in the hover card

Bambu Lab Spools¶

Slots containing Bambu Lab spools (identified by RFID) do not show assign/unassign buttons. These spools are managed automatically by the AMS.

Configure AMS Slot¶

AMS slot configuration tells the printer what filament profile to use for a specific slot. This is separate from inventory — it controls how the printer handles the filament during printing (temperature, flow rate, pressure advance, etc.).

1. Hover over an AMS slot on the printer card
2. Click the menu button ()
3. Select Configure Slot
4. Choose a filament preset
5. Optionally select a K profile and custom color
6. Click Configure Slot to apply

Where Configure Slot Presets Come From¶

The preset list in the Configure Slot modal comes from the same three sources as the spool form, but filtered by printer model:

Only presets compatible with the specific printer model are shown, reducing clutter and preventing mismatches.

Usage Tracking¶

Bambuddy tracks filament consumption automatically using 3MF slicer data as the primary source for all spools.

3MF Slicer Estimates (Primary)¶

For all spools — both Bambu Lab (RFID) and third-party — Bambuddy uses the per-filament used_g data from the archived 3MF file:

• Extracts per-filament usage from the slicer's slice_info
• Maps 3MF filament slots to physical AMS trays using the actual AMS mapping from the print command
• For slicer-initiated prints (BambuStudio, OrcaSlicer, Bambu Handy): captures the ams_mapping directly from the MQTT print command, ensuring the correct tray is tracked regardless of which application starts the print
• For queue prints: uses the stored AMS mapping for exact slot-to-tray resolution
• For single-filament prints: uses the printer's active tray for reliable tracking
• For completed prints: uses the full slicer estimate
• For failed/aborted prints: uses per-layer G-code data for accurate partial tracking, with linear progress scaling as fallback

AMS Remain% Delta (Fallback)¶

When 3MF data is unavailable (e.g., G-code-only prints without an archived 3MF file), Bambuddy falls back to AMS remain% tracking:

• Captures remain% at print start and end to compute consumption deltas
• Only used for trays not already tracked via 3MF

Usage History¶

Each consumption event is recorded with:

• Spool ID and printer
• Print name
• Weight consumed (grams)
• Percentage consumed
• Print status (completed / failed / aborted)
• Cost (calculated from spool cost/kg)

Cost Tracking¶

Track filament costs per spool and see cost breakdowns for every print.

Setting Cost Per Kg¶

Each spool can have an individual Cost per kg value, set in the Additional section of the spool form. This value is used to calculate the cost of each print based on actual filament consumption.

How Cost Calculation Works¶

When a print completes, Bambuddy calculates the cost for each spool used:

1. Per-spool cost: Uses the spool's cost_per_kg if set
2. Default fallback: Uses the global Default Filament Cost from Settings → Filament
3. Formula: cost = (weight_used_grams / 1000) × cost_per_kg

The calculated cost is stored in the usage history record and aggregated to the archive's total cost.

Cost Display¶

• Print modal: Shows a real-time cost preview based on loaded filaments and their cost/kg values before starting a print
• Archive cards: Display the total filament cost for each print
• Inventory table: Includes a sortable "Cost/kg" column (hidden by default — enable via column settings)
• Statistics: Total cost across all prints is included in the stats summary

Recalculating Costs¶

If you update spool prices or add cost data retroactively, use Recalculate Costs on the Archives page to update all archive costs based on current filament prices. This recalculates costs using:

1. Spool usage history records (by archive ID)
2. Legacy usage records (by print name, for older records)
3. Filament catalog prices (if no usage records exist)

Default Filament Cost & Currency¶

Configure in Settings → Filament:

Settings¶

Configure the inventory system in Settings > Filament.

Filament Tracking¶

Choose between:

• Built-in Inventory — Use Bambuddy's spool management
• Spoolman — Use external Spoolman integration

Sync Weights from AMS¶

When using built-in inventory, a Sync Weights from AMS button appears below the mode selector. This force-syncs all inventory spool weights from the live AMS remain% sensor values of connected printers.

Use this to recover from corrupted weight data — for example, if a printer power-off event caused all spool fill levels to drop to zero. The sync overwrites the stored weight_used values with the current AMS readings. Printers must be online for the sync to work.

Spool Catalog¶

Pre-defined empty spool weights for quick selection when adding spools. Ships with 90+ entries covering common manufacturers.

Color Catalog¶

Pre-defined color palettes from filament brands. Ships with 600+ colors across 20 brands. Used in the color picker when adding or editing spools.

Import File Format¶

Both catalogs accept a JSON array. Spool catalog entries:

[
  { "name": "Brand - Spool Type", "weight": 210 }
]

Color catalog entries:

[
  { "manufacturer": "eSUN", "color_name": "Silk Gold", "hex_color": "#C48E2F", "material": "PLA Silk" }
]

FAQ¶

My material isn't in the dropdown (e.g., PCTG, PHA, PP)¶

Type the material name directly into the Material field. A green "Use custom material" option appears at the bottom of the dropdown. Custom materials work the same as built-in ones for all tracking features.

Do I need to pick a filament profile for every spool?¶

No. Use Quick Add (Stock) mode to add spools with just a material type — no slicer preset, brand, or subtype required. Stock spools track weight, usage, and cost just like configured spools, but they aren't linked to a printer filament profile. You can filter stock spools on the inventory page and edit them later to assign a profile when needed.

In full mode, the Slicer Preset field is required. It links the spool to a filament profile ID that the printer understands. If you're just inventorying filament for tracking purposes, pick the closest available preset — for example, use a generic "PETG Basic" preset for a third-party PETG spool.

If you have custom slicer profiles (e.g., a PCTG profile in OrcaSlicer), import them via Local Profiles so they appear in the preset dropdown.

I have different printers (P1S, H2D) and nozzles — do presets matter?¶

The spool inventory itself is printer-agnostic. You can add a spool once and assign it to any printer's AMS slot. Printer model filtering only applies when configuring an AMS slot (telling the printer which profile to use), not when adding spools to inventory.

When you configure an AMS slot, the preset list is automatically filtered by that printer's model — so you'll only see P1S-compatible presets when configuring a P1S slot, and H2D-compatible presets when configuring an H2D slot.

Is inventory only for loaded filaments?¶

No. The inventory tracks all your spools — loaded and unloaded. You can add every spool you own to the inventory, even spools sitting on a shelf. The "In Printer" summary card shows how many are currently loaded in AMS slots, but unloaded spools are tracked just the same (weight remaining, usage history, cost, etc.).

Where do the "Slicer Preset" profiles come from?¶

They come from three sources, checked in order:

1. Your Bambu Cloud account — if you've logged in via Cloud Profiles, all your synced filament presets appear (including custom ones you've created in BambuStudio or OrcaSlicer and synced to cloud)
2. Local OrcaSlicer imports — if you've imported .orca_filament, .bbscfg, or .bbsflmt files via Local Profiles
3. Built-in fallback table — ~150 Bambu Lab filament IDs that are always available, no login needed

If you're not logged into Bambu Cloud, you'll still see local imports and the built-in table.

What's the difference between "Assign Spool" and "Configure Slot"?¶

Assigning a spool is the simplest workflow — it handles both tracking and printer configuration in one step. Use "Configure Slot" when you want to manually override settings or set up a slot without an inventory spool.

Tips¶