AMS & Humidity Monitoring¶

Bambuddy provides comprehensive monitoring for your AMS (Automatic Material System) and AMS-HT (High Temperature) units.

AMS Slot Status¶

Each AMS slot displays:

RFID Re-read¶

Refresh filament information for individual AMS slots:

1. Hover over an AMS slot on the printer card
2. Click the menu button () that appears
3. Select Re-read RFID
4. A loading indicator appears while the printer reads the RFID tag
5. Filament information updates automatically when complete

Configure AMS Slot¶

Manually configure AMS slots for third-party or generic filaments. This tells the printer which filament profile to use for a specific slot (temperatures, flow rate, pressure advance).

1. Hover over an AMS slot on the printer card
2. Click the menu button () that appears
3. Select Configure Slot
4. Choose a filament preset (from Bambu Cloud, local OrcaSlicer imports, or the built-in Bambu filament catalog — see preset sources)
5. Select a matching K profile (pressure advance calibration)
6. Optionally set a custom color using the color picker
7. Click Configure Slot to apply

Color Picker Features:

• 8 basic colors shown by default (White, Black, Red, Blue, Green, Yellow, Orange, Gray)
• Click + to expand 24 additional colors
• Enter custom hex codes or color names (e.g., "brown", "FF8800")
• Live preview of selected color

Printer Model Filtering¶

Filament presets in the Configure AMS Slot modal are automatically filtered by the printer model. This means you only see presets that are compatible with the printer you are configuring:

• Cloud presets are matched by the model suffix in the preset name (e.g., @BBL X1C, @BBL P1S, @BBL H2D). Generic presets without a model suffix are always included.
• Local presets are filtered by their compatible_printers field to show only those that list the current printer model.
• The currently-configured preset for the slot is always shown in the list, regardless of model filter, so you can see what is already set even if the preset would otherwise be filtered out.

This filtering reduces clutter and prevents accidentally selecting a preset intended for a different printer.

Pre-Population for Configured Slots¶

When you open the Configure AMS Slot modal for a slot that already has a configuration, Bambuddy pre-populates the form fields so you can review or adjust the current settings without starting from scratch:

• Filament preset — The previously-configured preset is pre-selected. Bambuddy resolves this from the saved preset mapping or by matching the slot's tray_info_idx to the corresponding preset.
• Color — The color picker is pre-populated with the slot's current filament color.
• K-profile — The active pressure advance profile is pre-selected by matching the slot's cali_idx to the available K-profile entries.
• Auto-scroll — The preset list automatically scrolls to the selected item so it is visible without manual scrolling.

Multi-AMS Support¶

Bambuddy supports multiple AMS units per printer:

• Up to 4 AMS units (16 total slots)
• Each unit displayed with its slots
• Visual indication of active slot during printing

External Spool Holders¶

Printers without an AMS (or with filament loaded outside the AMS) use an external spool holder. The H2D is a dual-nozzle printer with two external spool positions — Ext-L (left) and Ext-R (right) — each feeding its respective nozzle. Bambuddy displays both external slots and supports configuring, color-setting, and K-profile assignment for each one independently.

Humidity Monitoring¶

Track humidity levels inside your AMS units:

Current Reading¶

The humidity percentage is displayed on the printer card:

Configurable Thresholds¶

Set custom warning thresholds in Settings:

1. Go to Settings > General
2. Find AMS Humidity Threshold
3. Set your preferred warning level
4. Save changes

Temperature Monitoring¶

For AMS-HT (High Temperature) units, temperature is also tracked:

Remote AMS Drying¶

Control AMS drying directly from Bambuddy — no need to use the printer's touchscreen. Start, monitor, and stop drying sessions for AMS 2 Pro and AMS-HT units.

Supported Hardware¶

Remote drying requires an AMS unit with built-in heating:

Printer Firmware Requirements¶

Not all printers support remote drying commands. The following minimum firmware versions are required:

Power Supply Requirements¶

AMS 2 Pro and AMS-HT units require an external power supply (PSU) to run the drying heater. Without it, the AMS can only monitor humidity — it cannot actively dry.

The printer firmware reports power constraints via the dry_sf_reason field per AMS unit. Bambuddy reads these automatically:

When a power constraint is detected, the drying button is disabled and shows a "Power required" tooltip. This applies to manual drying, queue auto-drying, and ambient drying — the scheduler skips AMS units with active dry_sf_reason entries.

HMS Error Codes (AMS Power)¶

When the AMS encounters a power-related issue, the printer reports it as an HMS (Health Management System) error. These appear in Bambuddy's HMS error panel:

AMS 2 Pro Errors:

AMS-HT Errors:

Starting a Drying Session¶

1. Find the AMS 2 Pro or AMS-HT card on the Printers page
2. Click the flame icon in the AMS card header
3. In the drying popover:
   • Select filament type — Choose from PLA, PETG, TPU, ABS, ASA, PA, PC, or PVA
   • Temperature — Auto-set from BambuStudio official presets; adjust manually with the slider or input field
   • Duration — Auto-set from presets (1–24 hours); adjust as needed
4. Click Start

Monitoring Drying Progress¶

When drying is active, a status bar appears between the AMS header and slot grid:

• Time remaining — Countdown in hours and minutes (e.g., "3h 42m" or "42m")
• The flame icon in the header turns amber to indicate active drying

Stopping a Drying Session¶

• Click the × button on the drying status bar, or
• Click the flame icon (when drying is active, it acts as a stop button)

Permissions¶

Queue Auto-Drying¶

Automatically dry AMS filament between scheduled prints. When a printer is idle and humidity exceeds the configured threshold, Bambuddy starts a drying session to keep filament in optimal condition before the next print begins.

How It Works¶

1. The scheduler checks idle printers that have scheduled queue items
2. For each AMS unit, it reads the current humidity level
3. If humidity exceeds the Fair (orange) threshold from Settings, drying is triggered
4. The drying temperature and duration are determined by the loaded filament types using the configured drying presets
5. After a minimum of 30 minutes, humidity is re-checked — if it drops to or below the threshold, drying is stopped early
6. When the next scheduled print is ready to start, any remaining drying is stopped and the print begins

Conservative Temperature Selection¶

When an AMS unit contains mixed filament types (e.g., PLA and PETG in the same unit), the scheduler uses conservative parameters:

• Temperature — The lowest temperature across all loaded filaments (to avoid overheating sensitive materials)
• Duration — The longest duration across all loaded filaments

Enabling Auto-Drying¶

1. Go to Settings > AMS Display Thresholds
2. Set the Fair (orange) ≤ humidity threshold — this is the trigger point for auto-drying
3. Scroll to Queue Auto-Drying
4. Enable Enable auto-drying
5. Optionally enable Wait for drying to complete (blocking mode)

Blocking vs Non-Blocking Mode¶

When Auto-Drying Stops¶

Auto-drying is stopped automatically when:

• Humidity drops below threshold — checked every scheduler cycle; once humidity is at or below the Fair value, drying stops
• A scheduled print is ready to start (non-blocking mode)
• The queue item's schedule is removed or changed to "Queue Only"
• All scheduled items are removed from the queue
• Auto-drying is disabled in Settings

Requirements¶

• At least one scheduled queue item (items in "Queue Only" mode do not trigger auto-drying)
• AMS 2 Pro or AMS-HT unit (original AMS does not support drying)
• Supported printer firmware (see firmware requirements above)
• Humidity above the Fair threshold

Ambient Drying¶

Automatically dry filament on any idle printer whenever AMS humidity exceeds the configured threshold — no scheduled prints required. While queue auto-drying only activates when prints are scheduled, ambient drying keeps filament dry on all idle printers at all times.

How It Works¶

1. The scheduler continuously monitors all idle printers
2. For each AMS unit, it reads the current humidity level
3. If humidity exceeds the Fair (orange) threshold from Settings, drying is triggered
4. The drying temperature and duration are determined by the loaded filament types using the configured drying presets
5. After a minimum of 30 minutes, humidity is re-checked — if it drops to or below the threshold, drying is stopped early

Unlike queue auto-drying, ambient drying does not require any scheduled queue items. It runs whenever a printer is idle and its AMS humidity is above the threshold.

Enabling Ambient Drying¶

1. Go to Settings > Print Queue
2. Find Ambient Drying
3. Enable Enable ambient drying

Using Both Modes Together¶

Ambient drying and queue auto-drying can be enabled simultaneously. They complement each other:

When both are enabled and a printer has scheduled prints, queue auto-drying takes precedence (since it is aware of print scheduling and blocking/non-blocking behavior). On printers with no scheduled prints, ambient drying takes over.

Requirements¶

• AMS 2 Pro or AMS-HT unit (original AMS does not support drying)
• Supported printer firmware (see firmware requirements above)
• Humidity above the Fair threshold
• No active power constraints on the AMS unit (see power supply requirements)

Configurable Drying Presets¶

Customize the drying temperature and duration for each filament type. These presets are used by both manual drying, queue auto-drying, and ambient drying.

Default Presets¶

Defaults are based on BambuStudio's official filament drying profiles:

Editing Presets¶

1. Go to Settings > AMS Display Thresholds
2. Find the Drying Presets table
3. Edit temperature (°C) and duration (hours) for each filament type
4. Changes auto-save

Historical Charts¶

Click on the humidity or temperature indicator to view historical data:

Time Ranges¶

• 6 hours - Recent trends
• 24 hours - Daily pattern
• 48 hours - Extended view
• 7 days - Weekly overview

Chart Features¶

• Min/Max/Avg statistics
• Threshold reference lines
• Interactive tooltips
• Zoom and pan

Data Retention¶

AMS data is stored for historical analysis:

Default Retention¶

• 30 days of humidity/temperature data
• Configurable in Settings

Configuring Retention¶

1. Go to Settings > General
2. Find AMS Data Retention
3. Set number of days (1-365)
4. Older data is automatically purged

AMS Notifications¶

Get notified about AMS conditions:

Available Alerts¶

Setting Up¶

1. Go to Settings > Notifications
2. Add or edit a provider
3. Enable AMS-related events
4. Save changes

Full notifications guide

AMS-HT vs Standard AMS¶

AMS-HT Temperature Control¶

AMS-HT units can actively dry filament. See Remote AMS Drying for setup and usage.

Custom AMS Labels¶

Assign friendly names to your AMS units to easily identify them in multi-AMS setups.

AMS Info Card¶

Hover over any AMS label (e.g. "AMS-A") on the Printers page to see a popover with:

• Serial Number — The hardware serial from MQTT
• Firmware Version — Parsed from the printer's get_version response
• Friendly Name — An editable text field for your custom label

Setting a Custom Label¶

1. Hover over the AMS label on the Printers page
2. Type a name in the "AMS Name" field (e.g. "Silk Colours", "Workshop AMS")
3. Click Save or press Enter
4. To remove a label, clear the field and save, or click Clear

Label Persistence¶

Labels are stored by AMS serial number, so they persist when the AMS is moved to a different printer. If the AMS serial is not available (older firmware), a fallback key based on printer ID and AMS position is used.

Custom labels also appear in the Inventory page location column alongside the slot identifier, making it easy to find spools across a print farm.

Slot Numbers¶

Each filament color circle now displays a 1-based slot number with automatically inverted text contrast — black text on light filaments, white text on dark filaments.

AMS Discovery¶

Bambuddy automatically discovers connected AMS units:

• Detected during printer connection
• Updates when AMS configuration changes
• No manual configuration needed

Dual-Nozzle Wiring¶

For H2D and other dual-nozzle printers, Bambuddy displays the AMS wiring configuration:

• Which AMS units feed which nozzle
• Visual diagram of connections
• Helps plan multi-material prints

Nozzle-Aware Filament Mapping¶

On dual-nozzle printers (H2D, H2D Pro), each AMS unit is physically connected to either the left or right nozzle. When a 3MF file assigns filaments to specific nozzles, Bambuddy constrains filament matching to only AMS trays connected to the correct nozzle.

How it works:

1. The 3MF file contains filament_nozzle_map and physical_extruder_map in project_settings.config, mapping each filament slot to a target nozzle (0 = right, 1 = left)
2. The printer reports ams_extruder_map via MQTT, indicating which AMS unit feeds which nozzle
3. When matching filaments to AMS slots, only trays on the correct nozzle are considered
4. If no trays exist on the target nozzle, matching falls back to the full tray list

This applies to:

• Print scheduler — automatic filament matching for queued prints
• Reprint modal — filament mapping when reprinting from archives
• Queue modal — filament mapping when adding to queue
• Multi-printer selection — per-printer mapping for print farms

The filament mapping UI shows L (left) and R (right) badges next to each filament requirement for dual-nozzle prints.

Spoolman Integration¶

Sync AMS slots with Spoolman for complete filament tracking:

1. Configure Spoolman integration in Settings
2. AMS slots sync automatically
3. Track usage across your inventory

Spoolman integration guide

Tips¶