Plugin: BambuLab
The BambuLab Plugin is a Driver plugin that extends FilaMan with full BambuLab 3D printer integration. It enables communication via MQTT, AMS slot management, and automatic filament setting assignment.
Installation: → Admin: Plugin Management
Overview
| Property | Value |
|---|---|
| Plugin Type | Driver (Printer Driver) |
| Author | FilaMan |
| Source | Fire-Devils/filaman-plugins (Registry) |
| Connection | MQTT over local network |
| Capabilities | AMS support, RFID detection, Automatic filament matching |
Supported Printer Models
| Model | AMS Type |
|---|---|
| P1P / P1S | AMS (Automatic Material System) |
| P2S | AMS |
| X1C / X1E | AMS |
| A1 / A1 Mini | AMS Lite |
| H2C / H2D / H2S | AMS |
Configuration
When adding or editing a BambuLab printer, the plugin shows the following configuration fields:
| Field | Required | Description |
|---|---|---|
| Printer Model | Yes | Printer model (P1S, P1P, P2S, X1C, X1E, A1, A1 Mini, H2C, H2D, H2S) — determines the AMS data structure and number of slots |
| IP/Hostname | Yes | IP address or hostname of the printer on your local network |
| Serial Number | Yes | Serial number of the printer (found on the device or in the Bambu Handy app) |
| Access Code | Yes | Access code from the printer's LAN settings |
| Reconnect Interval | No | Interval in minutes for automatic reconnection on connection loss (default: 5, range: 1–60) |
Tip: You can find the serial number and access code in the Bambu Handy App under the printer settings, or directly on the printer under Settings → Network → LAN Mode.
What Gets Installed?
Upon installation of the plugin and when a BambuLab printer is first started, the following components are automatically set up:
Printer Parameters
The plugin creates 10 extra fields (called "Printer Parameters") specifically needed for BambuLab printers. These fields are automatically created as System Extra Fields (visible under Admin: Extra Fields).
| Parameter | Description | Field Type |
|---|---|---|
Bambu Material Index (bambu_idx) |
Material index from the BambuLab filament list — select the matching BambuLab material from a dropdown | Dropdown |
Tray Info Index (bambu_tray_idx) |
Index identifying the tray entry in the BambuLab system | Text |
Setting ID (bambu_setting_id) |
Print profile ID used internally by BambuLab for print settings | Text |
Calibration Index (bambu_cali_idx) |
Calibration index for print calibration | Text |
K Value (bambu_k_value) |
K value (Pressure Advance) for extrusion control | Number |
Flow Ratio (bambu_flow_ratio) |
Flow rate / extrusion multiplier | Number |
Bed Temperature (bambu_bed_temp) |
Print bed temperature in °C | Number |
Nozzle Temp Min (bambu_nozzle_temp_min) |
Minimum nozzle temperature in °C | Number |
Nozzle Temp Max (bambu_nozzle_temp_max) |
Maximum nozzle temperature in °C | Number |
Max Volumetric Speed (bambu_max_volumetric_speed) |
Maximum volumetric flow speed in mm³/s | Number |
Where Do Printer Parameters Appear?
Printer parameters appear in two places in the user interface:
1. Filament Edit Page
Under the "Printer Parameters" section on the filament edit page.
- This is where you set default values for a filament (e.g. "PLA generally at 210–220°C")
- These values serve as the base for all spools of this filament
- When creating a new PLA filament, for example, enter the BambuLab parameters that are typical for this filament here
2. Spool Edit Page
Under the "Printer Parameters" section on the spool edit page.
- This is where you can set spool-specific values that differ from the filament defaults
- Spool parameters take priority over filament parameters when sending to the printer
- Useful when a specific spool requires different calibration values or temperatures
Priority rule: When sending filament settings to the printer, spool parameters and filament parameters are merged. If a value exists for a parameter at both spool and filament level, the spool value is used.
Populating Printer Parameters
There are three ways to populate the parameters:
1. Enter Manually
Open the filament or spool edit form and fill in the values in the "Printer Parameters" section.
- The Bambu Material Index can be conveniently selected from a dropdown — the list contains all material types supported by BambuLab
- The remaining fields (temperatures, K value, etc.) can be entered directly as numbers or text
- This method is especially suitable for filaments you are setting up for the first time
2. Import from AMS Slot
On the spool detail page, you can import parameters directly from an AMS slot:
- Click on an AMS slot dot in the printer slot overview
- Select from the context menu:
- "Import to spool" — Imports the values (tray index, temperatures, calibration ID, etc.) into the spool's printer parameters
- "Import to spool & filament" — Imports the values into both the spool and its associated filament
Tip: This method is especially convenient when using BambuLab original filament — all parameters are automatically read from the AMS and imported.
3. Automatically When Adding a Printer
When a new BambuLab printer is added and another BambuLab printer already exists, FilaMan automatically copies the printer parameters from the existing printer. This saves you from entering the parameters again.
AMS Slot Display
After a successful connection, FilaMan shows all AMS slots and their current contents on the printer page and the spool detail page:
- AMS Slots — Up to 4 slots per AMS unit
- External Tray — The printer's external spool feeder
- Displayed information includes: filament type, color, temperature range, and calibration status
- The display updates in real time via Server-Sent Events (SSE)
For more details on assigning spools to slots: → Printers: Setting Spools
Migration from Older Versions
If you are updating the BambuLab plugin from an older version, existing parameters are automatically renamed:
| Old Name | New Name |
|---|---|
bambu_cali_id |
bambu_cali_idx |
bambu_k |
bambu_k_value |
bambu_max_volspeed |
bambu_max_volumetric_speed |
bambu_nozzle_temp |
bambu_nozzle_temp_min |
Your existing data is preserved — the renaming happens automatically on the first printer connection after the update.
Note: If you previously used Spoolman with BambuLab fields, FilaMan also automatically migrates this data into the new printer parameter format.