Home A - Z
Page Index

Blame

ae873c Manuel Weiser 2026-02-26 21:17:39
Add BambuLab plugin documentation and integration details - Updated contents in German and English to include a new section for the BambuLab plugin. - Modified printer management documentation to reflect BambuLab printer specifics. - Enhanced admin area with device actions and auto-assign configuration for BambuLab integration. - Added detailed configuration and parameter management for BambuLab printers. - Included migration notes for users updating from older versions of the BambuLab plugin.
1 
# Plugin: BambuLab
2
3
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.
4
f48813 Manuel Weiser 2026-03-02 13:55:54
docs: Add SpoolmanDB Import and Spoolman API plugin documentation; update login and admin sections for SSO support
5
> ⚠️ **Important:** Controlling the printer via FilaMan (e.g. setting spools in the printer/AMS) only works when the printer is in **LAN-only Mode** AND **Developer Mode**.
6
fe70cf Manuel Weiser 2026-03-09 08:10:11
Update documentation links to use consistent casing and absolute paths - Changed links in German documentation to use absolute paths with consistent casing. - Updated links in English documentation to follow the same format. - Ensured all navigation links point to the correct sections across all documents.
7
**Installation:** → [Admin: Plugin Management](/Docs/En/11-Admin#115-system-plugin-management)
ae873c Manuel Weiser 2026-02-26 21:17:39
Add BambuLab plugin documentation and integration details - Updated contents in German and English to include a new section for the BambuLab plugin. - Modified printer management documentation to reflect BambuLab printer specifics. - Enhanced admin area with device actions and auto-assign configuration for BambuLab integration. - Added detailed configuration and parameter management for BambuLab printers. - Included migration notes for users updating from older versions of the BambuLab plugin.
8
9
---
10
11
## Overview
12
13
| Property | Value |
14
|----------|-------|
15
| **Plugin Type** | Driver (Printer Driver) |
16
| **Author** | FilaMan |
17
| **Source** | [Fire-Devils/filaman-plugins](https://github.com/Fire-Devils/filaman-plugins) (Registry) |
18
| **Connection** | MQTT over local network |
19
| **Capabilities** | AMS support, RFID detection, Automatic filament matching |
20
21
---
22
23
## Supported Printer Models
24
25
| Model | AMS Type |
26
|-------|----------|
27
| **P1P / P1S** | AMS (Automatic Material System) |
66cf3f Manuel Weiser 2026-02-27 13:14:37
docs: Update plugin management details and add new printer models for BambuLab integration
28
| **P2S** | AMS |
29
| **X1C / X1E** | AMS |
ae873c Manuel Weiser 2026-02-26 21:17:39
Add BambuLab plugin documentation and integration details - Updated contents in German and English to include a new section for the BambuLab plugin. - Modified printer management documentation to reflect BambuLab printer specifics. - Enhanced admin area with device actions and auto-assign configuration for BambuLab integration. - Added detailed configuration and parameter management for BambuLab printers. - Included migration notes for users updating from older versions of the BambuLab plugin.
30
| **A1 / A1 Mini** | AMS Lite |
66cf3f Manuel Weiser 2026-02-27 13:14:37
docs: Update plugin management details and add new printer models for BambuLab integration
31
| **H2C / H2D / H2S** | AMS |
ae873c Manuel Weiser 2026-02-26 21:17:39
Add BambuLab plugin documentation and integration details - Updated contents in German and English to include a new section for the BambuLab plugin. - Modified printer management documentation to reflect BambuLab printer specifics. - Enhanced admin area with device actions and auto-assign configuration for BambuLab integration. - Added detailed configuration and parameter management for BambuLab printers. - Included migration notes for users updating from older versions of the BambuLab plugin.
32
33
---
34
35
## Configuration
36
37
When adding or editing a BambuLab printer, the plugin shows the following configuration fields:
38
39
| Field | Required | Description |
40
|-------|----------|-------------|
66cf3f Manuel Weiser 2026-02-27 13:14:37
docs: Update plugin management details and add new printer models for BambuLab integration
41
| **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 |
ae873c Manuel Weiser 2026-02-26 21:17:39
Add BambuLab plugin documentation and integration details - Updated contents in German and English to include a new section for the BambuLab plugin. - Modified printer management documentation to reflect BambuLab printer specifics. - Enhanced admin area with device actions and auto-assign configuration for BambuLab integration. - Added detailed configuration and parameter management for BambuLab printers. - Included migration notes for users updating from older versions of the BambuLab plugin.
42
| **IP/Hostname** | Yes | IP address or hostname of the printer on your local network |
43
| **Serial Number** | Yes | Serial number of the printer (found on the device or in the Bambu Handy app) |
44
| **Access Code** | Yes | Access code from the printer's LAN settings |
45
| **Reconnect Interval** | No | Interval in minutes for automatic reconnection on connection loss (default: 5, range: 1–60) |
46
47
> **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**.
48
49
---
50
51
## What Gets Installed?
52
53
Upon installation of the plugin and when a BambuLab printer is first started, the following components are automatically set up:
54
55
### Printer Parameters
56
fe70cf Manuel Weiser 2026-03-09 08:10:11
Update documentation links to use consistent casing and absolute paths - Changed links in German documentation to use absolute paths with consistent casing. - Updated links in English documentation to follow the same format. - Ensured all navigation links point to the correct sections across all documents.
57
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](/Docs/En/11-Admin#114-extra-fields)).
ae873c Manuel Weiser 2026-02-26 21:17:39
Add BambuLab plugin documentation and integration details - Updated contents in German and English to include a new section for the BambuLab plugin. - Modified printer management documentation to reflect BambuLab printer specifics. - Enhanced admin area with device actions and auto-assign configuration for BambuLab integration. - Added detailed configuration and parameter management for BambuLab printers. - Included migration notes for users updating from older versions of the BambuLab plugin.
58
59
| Parameter | Description | Field Type |
60
|-----------|-------------|------------|
61
| **Bambu Material Index** (`bambu_idx`) | Material index from the BambuLab filament list — select the matching BambuLab material from a dropdown | Dropdown |
62
| **Tray Info Index** (`bambu_tray_idx`) | Index identifying the tray entry in the BambuLab system | Text |
63
| **Setting ID** (`bambu_setting_id`) | Print profile ID used internally by BambuLab for print settings | Text |
64
| **Calibration Index** (`bambu_cali_idx`) | Calibration index for print calibration | Text |
65
| **K Value** (`bambu_k_value`) | K value (Pressure Advance) for extrusion control | Number |
66
| **Flow Ratio** (`bambu_flow_ratio`) | Flow rate / extrusion multiplier | Number |
67
| **Bed Temperature** (`bambu_bed_temp`) | Print bed temperature in °C | Number |
68
| **Nozzle Temp Min** (`bambu_nozzle_temp_min`) | Minimum nozzle temperature in °C | Number |
69
| **Nozzle Temp Max** (`bambu_nozzle_temp_max`) | Maximum nozzle temperature in °C | Number |
70
| **Max Volumetric Speed** (`bambu_max_volumetric_speed`) | Maximum volumetric flow speed in mm³/s | Number |
71
72
---
73
74
## Where Do Printer Parameters Appear?
75
76
Printer parameters appear in two places in the user interface:
77
78
### 1. Filament Edit Page
79
80
Under the **"Printer Parameters"** section on the filament edit page.
81
82
- This is where you set **default values** for a filament (e.g. "PLA generally at 210–220°C")
83
- These values serve as the **base** for all spools of this filament
84
- When creating a new PLA filament, for example, enter the BambuLab parameters that are typical for this filament here
85
86
### 2. Spool Edit Page
87
88
Under the **"Printer Parameters"** section on the spool edit page.
89
90
- This is where you can set **spool-specific values** that differ from the filament defaults
91
- Spool parameters take **priority** over filament parameters when sending to the printer
92
- Useful when a specific spool requires different calibration values or temperatures
93
94
> **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.
95
96
---
97
98
## Populating Printer Parameters
99
100
There are three ways to populate the parameters:
101
102
### 1. Enter Manually
103
104
Open the filament or spool edit form and fill in the values in the "Printer Parameters" section.
105
106
- The **Bambu Material Index** can be conveniently selected from a dropdown — the list contains all material types supported by BambuLab
107
- The remaining fields (temperatures, K value, etc.) can be entered directly as numbers or text
108
- This method is especially suitable for filaments you are setting up for the first time
109
110
### 2. Import from AMS Slot
111
112
On the **spool detail page**, you can import parameters directly from an AMS slot:
113
114
1. Click on an AMS slot dot in the printer slot overview
115
2. Select from the context menu:
116
- **"Import to spool"** — Imports the values (tray index, temperatures, calibration ID, etc.) into the spool's printer parameters
117
- **"Import to spool & filament"** — Imports the values into both the spool and its associated filament
118
119
> **Tip:** This method is especially convenient when using BambuLab original filament — all parameters are automatically read from the AMS and imported.
120
121
### 3. Automatically When Adding a Printer
122
123
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.
124
125
---
126
127
## AMS Slot Display
128
129
After a successful connection, FilaMan shows all AMS slots and their current contents on the **printer page** and the **spool detail page**:
130
131
- **AMS Slots** — Up to 4 slots per AMS unit
132
- **External Tray** — The printer's external spool feeder
133
- Displayed information includes: filament type, color, temperature range, and calibration status
134
- The display updates in **real time** via Server-Sent Events (SSE)
135
fe70cf Manuel Weiser 2026-03-09 08:10:11
Update documentation links to use consistent casing and absolute paths - Changed links in German documentation to use absolute paths with consistent casing. - Updated links in English documentation to follow the same format. - Ensured all navigation links point to the correct sections across all documents.
136
For more details on assigning spools to slots: → [Printers: Setting Spools](/Docs/En/09-Printers#setting-spools--overview)
ae873c Manuel Weiser 2026-02-26 21:17:39
Add BambuLab plugin documentation and integration details - Updated contents in German and English to include a new section for the BambuLab plugin. - Modified printer management documentation to reflect BambuLab printer specifics. - Enhanced admin area with device actions and auto-assign configuration for BambuLab integration. - Added detailed configuration and parameter management for BambuLab printers. - Included migration notes for users updating from older versions of the BambuLab plugin.
137
138
---
139
140
## Migration from Older Versions
141
142
If you are updating the BambuLab plugin from an older version, existing parameters are automatically renamed:
143
144
| Old Name | New Name |
145
|----------|----------|
146
| `bambu_cali_id` | `bambu_cali_idx` |
147
| `bambu_k` | `bambu_k_value` |
148
| `bambu_max_volspeed` | `bambu_max_volumetric_speed` |
149
| `bambu_nozzle_temp` | `bambu_nozzle_temp_min` |
150
151
Your existing data is preserved — the renaming happens automatically on the first printer connection after the update.
152
153
> **Note:** If you previously used Spoolman with BambuLab fields, FilaMan also automatically migrates this data into the new printer parameter format.
154
155
---
156
fe70cf Manuel Weiser 2026-03-09 08:10:11
Update documentation links to use consistent casing and absolute paths - Changed links in German documentation to use absolute paths with consistent casing. - Updated links in English documentation to follow the same format. - Ensured all navigation links point to the correct sections across all documents.
157
← [Back: Tips & FAQ](/Docs/En/13-Faq) | [Next: Plugin: SpoolmanDB Import →](/Docs/En/15-Plugin-Spoolmandb)