Home A - Z
Page Index

Blame

57076d Manuel Weiser 2026-02-23 16:43:14
update
1 
# 7. Spools
2
3
**URL:** `http(s)://url/spools`
4
5
![Spools Page](../images/spools.png)
6
7
The Spools page shows your **physical filament inventory** – every individual spool you own. This is the core of FilaMan.
8
9
## Table Columns
10
11
| Column | Description |
12
|--------|-------------|
13
| **ID** | Unique internal ID of the spool |
14
| **FILAMENT** | Assigned filament product (name + color) |
15
| **MANUFACTURER** | Filament manufacturer |
16
| **MATERIAL** | Material type (PLA, PETG, ABS, etc.) |
17
| **STATUS** | Current fill level status (Full / Normal / Low / Critical / Empty) |
18
| **REMAINING** | Remaining weight in grams |
19
| **LOCATION** | Current storage location of the spool |
20
21
## Features
22
23
### Search
24
Searches filament name, manufacturer, and other fields.
25
26
### Filters
27
FilaMan offers extensive filtering options for spools:
28
- **All Statuses** – Filter by fill level status
29
- **All Locations** – Show only spools at a specific location
30
- **All Manufacturers** – Filter by manufacturer
31
- **All Materials** – Filter by material type
32
33
### Group by Filament
34
Toggle **"Group by Filament"** to group spools by their filament product. This gives a quick overview of how many spools of each filament you have.
35
36
### Add a Spool
37
Click **"Add Spool"** in the top right. The form includes:
38
- **Filament** – Select the associated filament product
39
- **Location** – Storage location of the spool
40
- **Initial Weight / Remaining Weight** – Starting weight and current remaining weight in grams
41
- **Purchase Price** – Purchase price (optional, for value calculation)
42
- **Purchase Date** – Purchase date (optional)
43
- **Notes** – Free-text note
44
- **Extra Fields** – If configured by the administrator
45
240011 Manuel Weiser 2026-04-08 20:25:37
docs: Add FilaManDB integration details and update related sections in user manuals
46
#### Load Spool Profile from FilaManDB
47
48
> **Prerequisite:** The FilamentDB plugin must be enabled under [Admin → System](/Docs/En/11-Admin).
49
50
In the spool data section (empty weight, diameter, width), the **"Load from FilaManDB"** button is available:
51
52
1. Click the button – a search field opens
53
2. Search for a spool profile (e.g. by manufacturer name or material type)
54
3. If available, an **image of the spool profile** is displayed
55
4. Select the matching profile – the spool data is automatically applied:
56
- **Empty Weight**
57
- **Outer Diameter**
58
- **Width**
59
- **Spool Material**
60
61
This feature is available both when **creating** and when **editing** spools.
62
63
→ More information: [Chapter 18: FilaManDB Community Database](/Docs/En/18-Filamandb)
64
a614e0 Manuel Weiser 2026-05-28 17:14:10
docs: Update admin and spool documentation to include NFC tag data import and app settings
65
#### Import Data from NFC Tag
66
67
> **Prerequisite:** A FilaMan scale (ESP32) must be powered on and connected to the network.
68
69
When creating a new spool, the **"Import from Tag"** button (highlighted in light blue) appears at the very top of the form. This feature lets you import filament data directly from an existing NFC tag — without any manual entry.
70
71
The button is **only clickable** when at least one scale is detected as active. If no scale is online, it remains grayed out.
72
73
**How it works:**
74
75
1. Click **"Import from Tag"** — a dialog opens
76
2. If multiple scales are connected, select the desired device
77
3. The dialog prompts you to place the spool on the scale and hold the tag ready
78
4. The scale reads the next NFC tag (waiting time: up to 30 seconds)
79
5. On success:
80
- The matching filament is pre-selected in the dropdown, if a filament with a matching material type and brand exists in the database
81
- A confirmation message shows the detected filament name
82
6. If no matching filament is found, a notice displays the material and brand from the tag — you can then select the filament manually
83
84
**Supported tag protocols:** OpenSpool (`"protocol": "openspool"`) and FilaMan (`"protocol": "filaman"`)
85
86
> 💡 **Tip:** To write tags in these formats, enable "RFID Extended Data" under [Admin → App Settings](/Docs/En/11-Admin#rfid-extended-data). The next time a tag is written via the scale, filament data will automatically be embedded in the chosen format.
87
57076d Manuel Weiser 2026-02-23 16:43:14
update
88
### Edit / Delete a Spool
89
In the actions column you can:
90
- ✏️ **Edit** – Update spool information (e.g. remaining weight after printing)
91
- 🗑️ **Delete** – Remove the spool from the system
92
f1cde5 Manuel Weiser 2026-03-14 19:37:26
docs: Add label printing feature to spool detail page
93
### Print Label
94
95
On a spool's detail page, you'll find the **"Print Label"** button. This opens the label designer where you can create and print a custom label for your spool.
96
97
**Settings:**
98
- **Width / Height (mm)** – Label dimensions
99
- **Font Size (%)** – Scales the text size on the label
100
- **QR Size (mm)** – Size of the QR code (links to the spool's detail page)
101
102
**Displayed Information:**
103
Use checkboxes to select which information appears on the label:
104
- QR code, Spool ID, Manufacturer, Material, Color
105
106
**Extra Fields:**
107
If extra fields are configured for spools or the associated filament (see [Admin → Extra Fields](/Docs/En/11-Admin)), they appear as additional checkboxes under the "Extra Fields" heading. This lets you optionally include information like drying temperatures or other custom data on the label. When fields from both the spool and the filament are present, the source is shown in parentheses.
108
109
All settings are saved in the browser and automatically restored on the next visit. Use **"Reset"** to restore the defaults.
110
57076d Manuel Weiser 2026-02-23 16:43:14
update
111
> 💡 **Tip:** Regularly update the remaining weight of your spools so that the Dashboard and low-stock alerts show accurate values.
112
113
---
114
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.
115
← [Back: Filaments](/Docs/En/06-Filaments) | [Next: Locations →](/Docs/En/08-Locations)