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:

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 your Bambu Studio cloud presets
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

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

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:

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:

• Set target temperature in printer settings
• Monitor heating status in Bambuddy
• Track temperature over time

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¶