Home A - Z
Page Index

Blame

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
1 
# Plugin: SpoolmanDB Import
2
c77603 Manuel Weiser 2026-04-08 20:56:34
docs: Update SpoolmanDB plugin documentation to indicate deprecation and replacement by FilaManDB
3
> **Deprecated:** This plugin is no longer needed and has been replaced by the built-in [FilaManDB plugin](/Docs/En/18-Filamandb). FilaManDB offers the same functionality (manufacturer, filament, and color import) and is already included as a built-in plugin in FilaMan — no separate installation required. Starting with version 1.2.2, the SpoolmanDB plugin will be **automatically removed** during update.
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
The **SpoolmanDB Import Plugin** allows you to import filament data from the [SpoolmanDB community database](https://github.com/Donkie/SpoolmanDB) directly into FilaMan. SpoolmanDB is an open, community-maintained database containing filament information from numerous manufacturers.
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)
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
8
9
---
10
11
## Overview
12
13
| Property | Value |
14
|----------|-------|
15
| **Plugin Type** | Import |
16
| **Author** | FilaMan |
17
| **Source** | [Fire-Devils/filaman-plugins](https://github.com/Fire-Devils/filaman-plugins) (Registry) |
18
| **Data Source** | [SpoolmanDB](https://github.com/Donkie/SpoolmanDB) (GitHub) |
19
| **Capabilities** | Manufacturer import, Filament import, Color import, Diameter filter |
20
21
---
22
23
## What is SpoolmanDB?
24
25
[SpoolmanDB](https://github.com/Donkie/SpoolmanDB) is a community-maintained open-source database containing filament information from many manufacturers. It includes:
26
27
- Manufacturer names
28
- Filament names and material types
29
- Colors (single and multi-color)
30
- Diameter, weight, and density
31
- Recommended extruder and bed temperatures
32
- Spool weight and spool material
33
- Surface properties (translucent, glow, etc.)
34
35
---
36
37
## Import Page
38
39
After installing the plugin, you can find the import page at:
40
41
**Admin → System → SpoolmanDB Import**
42
43
The import page guides you through the process in three steps.
44
45
---
46
47
## Step 1: Choose Import Mode
48
49
### Diameter Filter
50
51
Before selecting the import mode, you can optionally filter by **diameter**:
52
53
| Option | Description |
54
|--------|-------------|
55
| **All diameters** | No filtering |
56
| **1.75 mm** | Only 1.75 mm filaments (default) |
57
| **2.85 mm** | Only 2.85 mm filaments |
58
59
### Import Modes
60
61
| Mode | Description |
62
|------|-------------|
63
| **Import all** | Imports all filaments and manufacturers from SpoolmanDB |
64
| **By manufacturer** | Imports all filaments from a specific manufacturer — select the manufacturer from the dropdown |
65
| **Single filament** | Imports a specific filament — select manufacturer (optional filter) and filament |
66
67
---
68
69
## Step 2: Preview
70
71
After selecting the import mode, you can load a **preview**. Depending on the mode, it shows:
72
73
- **Import all:** Total count of manufacturers and filaments
74
- **By manufacturer:** Table listing all filaments from the chosen manufacturer (name, material, diameter)
75
- **Single filament:** Detail view with all available information (manufacturer, name, material, diameter, weight, density, color, temperatures)
76
77
> **Tip:** Review the preview carefully before starting the import.
78
79
---
80
81
## Step 3: Execute Import
82
83
Click **"Start Import"** to import the selected data into FilaMan.
84
85
### What Gets Imported?
86
87
| Data | Description |
88
|------|-------------|
89
| **Manufacturers** | Created as new manufacturers in FilaMan (if not already present) |
90
| **Filaments** | Created as new filaments with all available information |
91
| **Colors** | Created as new colors in color management (if not already present) |
92
93
### Duplicate Detection
94
95
- **Manufacturers** are matched by name (case-insensitive) — existing ones are skipped
96
- **Filaments** are matched by SpoolmanDB ID — previously imported ones are skipped
97
- **Colors** are matched by hex code — existing ones are reused
98
99
> **Important:** Existing data in FilaMan is **never** overwritten or modified. The import only creates new entries.
100
101
### Import Result
102
103
After the import completes, a summary is displayed:
104
105
| Category | Display |
106
|----------|---------|
107
| **Manufacturers** | Count created / skipped |
108
| **Filaments** | Count created / skipped |
109
| **Colors** | Count created / skipped |
110
| **Errors** | List of any errors (e.g. missing manufacturer assignment) |
111
112
---
113
114
## Imported Data
115
116
The following filament fields are imported from SpoolmanDB (if available):
117
118
| SpoolmanDB Field | FilaMan Field |
119
|-----------------|---------------|
120
| `manufacturer` | Manufacturer |
121
| `name` + `material` | Designation |
122
| `material` | Material type |
123
| `fill` | Material subgroup (e.g. glass fiber, carbon) |
124
| `diameter` | Diameter |
125
| `weight` | Raw material weight |
126
| `spool_weight` | Default spool weight |
127
| `spool_type` | Spool material |
128
| `density` | Density |
129
| `color_hex` / `color_hexes` | Colors (single/multi-color) |
130
| `multi_color_direction` | Multi-color style (gradient/striped) |
131
| `translucent` / `glow` / `finish` | Finish type |
132
| `extruder_temp`, `bed_temp` etc. | Extra fields (custom_fields) |
133
134
---
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
← [Back: Plugin: BambuLab](/Docs/En/14-Plugin-Bambulab) | [Next: Plugin: Spoolman API →](/Docs/En/16-Plugin-Spoolmanapi)