Blame

57076d Manuel Weiser 2026-02-23 16:43:14
update
1
# 9. Printers
2
3
**URL:** `http(s)://url/printers`
4
5
![Printers Page](../images/printers.png)
6
7
The Printers page is where you manage all **3D printers** registered in FilaMan.
8
9
## Table Columns
10
11
| Column | Description |
12
|--------|-------------|
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.
13
| **NAME** | Name of the printer (e.g. "Bambu Lab P1S #1") |
57076d Manuel Weiser 2026-02-23 16:43:14
update
14
| **MODEL** | Printer model designation |
15
| **DRIVER** | Printer driver / connection type |
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.
16
| **STATUS** | Current operational status of the printer (Connected / Disconnected) |
57076d Manuel Weiser 2026-02-23 16:43:14
update
17
| **ACTIONS** | Edit / Delete |
18
19
## Features
20
21
### Add a Printer
22
Click **"Add Printer"** in the top right. The form contains:
23
- **Name** – Unique name for the printer
24
- **Model** – Model designation
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.
25
- **Driver** – Driver or connection type (e.g. BambuLab, OctoPrint, Moonraker/Klipper)
26
- Additional printer-specific configuration options (depending on the driver)
57076d Manuel Weiser 2026-02-23 16:43:14
update
27
28
### Printer Integration
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.
29
When a printer is connected, FilaMan can automatically track filament consumption and update spool fill levels, provided the printer is integrated via a compatible API.
30
31
---
32
33
## BambuLab Integration
34
35
### Supported Models
36
FilaMan supports all BambuLab printers with an MQTT interface:
37
- **P1P / P1S** – with AMS (Automatic Material System)
38
- **X1 / X1C** – with AMS
39
- **A1 / A1 Mini** – with AMS Lite
40
41
### Configuration
42
When adding a BambuLab printer, the following information is required:
43
- **Host** – IP address of the printer on your local network
44
- **Serial** – Serial number of the printer (found on the printer or in the Bambu Handy app)
45
- **Access Code** – Access code (found in the printer's LAN settings)
46
- **Printer Model** – Model designation (e.g. P1S, X1C, A1) — determines whether AMS or AMS Lite is displayed
47
48
### AMS Slot Display
49
After a successful connection, FilaMan shows all AMS slots and their current contents:
50
- **AMS Slots** – Up to 4 slots per AMS unit (AMS) or 4 slots (AMS Lite)
51
- **External Tray** – The printer's external spool feeder
52
- Displayed information includes: filament type, color, temperature range, and calibration status
53
54
---
55
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.
56
> **Detailed information** about the BambuLab plugin (printer parameters, how to populate them, import, migration) can be found on the dedicated plugin page: → [Plugin: BambuLab](/Docs/En/14-Plugin-Bambulab)
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.
57
58
---
59
60
## Setting Spools — Overview
61
62
FilaMan offers two ways to send filament settings (material type, color, temperature) to a printer slot:
63
64
| Method | Description |
65
|--------|-------------|
66
| **Manual** | The user selects a slot on the spool page and sends the settings directly |
67
| **Automatic** | After weighing on an ESP32 scale, FilaMan detects insertion into an AMS slot and sends the settings automatically |
68
69
---
70
71
### Manual Assignment (Spool → Printer)
72
73
A spool can be manually assigned to a specific printer slot via the **spool detail page**.
74
75
**Prerequisites:**
76
- The spool must be linked to a filament
77
- At least one BambuLab printer must be connected (Status: Connected)
78
79
**Step by Step:**
80
1. Navigate to the **Spools page** (`/spools`) and open the desired spool
81
2. In the lower section of the spool detail page, you will see a **printer slot overview** — for each connected printer, the AMS slots are shown as colored dots:
82
- 🟢 **Colored dot** = Slot occupied (color matches the inserted filament)
83
- **Grey dot with X** = Slot empty
84
3. **Click on a slot dot** — a context menu opens with the following actions:
85
- **"Assign spool"** — Sends this spool's filament settings to the selected slot
86
- **"Import to spool"** — Imports the printer parameters (tray index, temperatures) from the slot into the spool
87
- **"Import to spool & filament"** — Imports the parameters into both the spool and its associated filament
88
4. Select **"Assign spool"** — FilaMan automatically gathers the appropriate parameters (tray index, temperature ranges, material type, color) and sends them to the printer
89
5. On success, a **confirmation message** appears; on failure, an error message is shown
90
91
> **Note:** The sent parameters are merged from the **printer parameters** of both the spool and the filament. Spool parameters take priority over filament parameters. These can be adjusted in the respective spool or filament settings.
92
93
> **Tip:** The slot overview updates automatically in real time via Server-Sent Events (SSE). When a spool is inserted into or removed from an AMS slot, the display changes immediately.
94
95
---
96
97
### Automatic Assignment (Auto-Assignment)
98
99
Automatic spool assignment allows you to automatically send filament settings to the printer after weighing a spool on the ESP32 scale, as soon as the spool is inserted into an AMS slot.
100
101
**Prerequisites:**
102
1. An ESP32 device (scale) must be registered in Device Management
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.
103
2. **Auto-Assign** must be enabled for the device (→ [Admin: Devices](/Docs/En/11-Admin#113-devices))
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.
104
3. At least one BambuLab printer must be connected (Status: Connected)
105
106
**Workflow:**
107
1. **Weighing** — A spool is placed on the ESP32 scale → weight is measured and sent to FilaMan
108
2. **Pending** — FilaMan identifies the spool (via RFID or manual assignment), caches the filament data (material type, color, temperatures), and sets it as "Pending" on **all** connected printers
109
3. **Insertion** — The spool is physically inserted into an AMS slot
110
4. **Detection** — FilaMan detects the tray data change via MQTT and automatically sends the correct filament settings to that specific slot
111
5. **Completion** — After successful transmission or timeout expiry, the pending status is cleared
112
113
**How does detection work?**
114
FilaMan compares tray fields (filament type, color, calibration ID, setting ID) against the last known values with every MQTT status message. As soon as fields in a slot change (= new spool inserted), the pending filament is automatically sent to that slot.
115
116
> **Note:** Auto-assignment works for both AMS slots and the external spool feeder.
117
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.
118
> **Important:** Auto-Assign is configured **per device** (scale), not per printer. When Auto-Assign is enabled, all connected printers are notified — the assignment happens automatically on whichever printer the spool is actually inserted into. Configuration: → [Admin: Devices](/Docs/En/11-Admin#113-devices)
57076d Manuel Weiser 2026-02-23 16:43:14
update
119
120
---
121
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.
122
← [Back: Locations](/Docs/En/08-Locations) | [Next: Settings →](/Docs/En/10-Settings)