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