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
3
Das **SpoolmanDB Import-Plugin** ermöglicht den Import von Filament-Daten aus der [SpoolmanDB Community-Datenbank](https://github.com/Donkie/SpoolmanDB) direkt in FilaMan. Die SpoolmanDB ist eine offene, von der Community gepflegte Datenbank mit Filament-Informationen zahlreicher Hersteller.
4
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.
5
**Installation:** → [Admin: Plugin-Verwaltung](/Docs/De/11-Admin#115-system-plugin-verwaltung)
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
6
7
---
8
9
## Übersicht
10
11
| Eigenschaft | Wert |
12
|-------------|------|
13
| **Plugin-Typ** | Import |
14
| **Autor** | FilaMan |
15
| **Quelle** | [Fire-Devils/filaman-plugins](https://github.com/Fire-Devils/filaman-plugins) (Registry) |
16
| **Datenquelle** | [SpoolmanDB](https://github.com/Donkie/SpoolmanDB) (GitHub) |
17
| **Fähigkeiten** | Hersteller-Import, Filament-Import, Farben-Import, Durchmesser-Filter |
18
19
---
20
21
## Was ist die SpoolmanDB?
22
23
Die [SpoolmanDB](https://github.com/Donkie/SpoolmanDB) ist eine von der 3D-Druck-Community gepflegte Open-Source-Datenbank, die Filament-Informationen vieler Hersteller enthält. Dazu gehören:
24
25
- Hersteller-Namen
26
- Filament-Bezeichnungen und Materialtypen
27
- Farben (Einzel- und Multicolor)
28
- Durchmesser, Gewicht und Dichte
29
- Empfohlene Extruder- und Betttemperaturen
30
- Spulengewicht und Spulenmaterial
31
- Oberflächen-Eigenschaften (transluzent, leuchtend, etc.)
32
33
---
34
35
## Import-Seite
36
37
Nach der Installation des Plugins finden Sie die Import-Seite unter:
38
39
**Admin → System → SpoolmanDB Import**
40
41
Die Import-Seite führt Sie in drei Schritten durch den Prozess.
42
43
---
44
45
## Schritt 1: Importmodus wählen
46
47
### Durchmesser-Filter
48
49
Vor der Auswahl des Importmodus können Sie optional nach **Durchmesser** filtern:
50
51
| Option | Beschreibung |
52
|--------|-------------|
53
| **Alle Durchmesser** | Keine Filterung |
54
| **1.75 mm** | Nur 1.75 mm Filamente (Standard) |
55
| **2.85 mm** | Nur 2.85 mm Filamente |
56
57
### Import-Modi
58
59
| Modus | Beschreibung |
60
|-------|-------------|
61
| **Alles importieren** | Importiert alle Filamente und Hersteller aus der SpoolmanDB |
62
| **Nach Hersteller** | Importiert alle Filamente eines bestimmten Herstellers — wählen Sie den Hersteller aus dem Dropdown |
63
| **Einzelnes Filament** | Importiert ein bestimmtes Filament gezielt — wählen Sie Hersteller (optional als Filter) und Filament aus |
64
65
---
66
67
## Schritt 2: Vorschau
68
69
Nach der Auswahl des Importmodus können Sie eine **Vorschau** laden. Je nach Modus wird angezeigt:
70
71
- **Alles importieren:** Gesamtzahl der Hersteller und Filamente
72
- **Nach Hersteller:** Tabelle mit allen Filamenten des gewählten Herstellers (Name, Material, Durchmesser)
73
- **Einzelnes Filament:** Detailansicht mit allen verfügbaren Informationen (Hersteller, Name, Material, Durchmesser, Gewicht, Dichte, Farbe, Temperaturen)
74
75
> **Tipp:** Prüfen Sie die Vorschau sorgfältig, bevor Sie den Import starten.
76
77
---
78
79
## Schritt 3: Import ausführen
80
81
Klicken Sie auf **„Import starten"**, um die ausgewählten Daten in FilaMan zu importieren.
82
83
### Was wird importiert?
84
85
| Daten | Beschreibung |
86
|-------|-------------|
87
| **Hersteller** | Werden als neue Hersteller in FilaMan angelegt (falls nicht bereits vorhanden) |
88
| **Filamente** | Werden als neue Filamente mit allen verfügbaren Informationen erstellt |
89
| **Farben** | Werden als neue Farben in der Farbverwaltung angelegt (falls nicht bereits vorhanden) |
90
91
### Duplikat-Erkennung
92
93
- **Hersteller** werden anhand des Namens (case-insensitive) erkannt — bereits vorhandene werden übersprungen
94
- **Filamente** werden anhand der SpoolmanDB-ID erkannt — bereits importierte werden übersprungen
95
- **Farben** werden anhand des Hex-Codes erkannt — bereits vorhandene werden wiederverwendet
96
97
> **Wichtig:** Bestehende Daten in FilaMan werden **nicht** überschrieben oder verändert. Der Import erstellt nur neue Einträge.
98
99
### Import-Ergebnis
100
101
Nach Abschluss des Imports wird eine Zusammenfassung angezeigt:
102
103
| Kategorie | Anzeige |
104
|-----------|---------|
105
| **Hersteller** | Anzahl erstellt / übersprungen |
106
| **Filamente** | Anzahl erstellt / übersprungen |
107
| **Farben** | Anzahl erstellt / übersprungen |
108
| **Fehler** | Liste eventueller Fehler (z. B. fehlende Hersteller-Zuordnung) |
109
110
---
111
112
## Importierte Daten
113
114
Die folgenden Filament-Felder werden aus der SpoolmanDB übernommen (sofern vorhanden):
115
116
| SpoolmanDB-Feld | FilaMan-Feld |
117
|-----------------|-------------|
118
| `manufacturer` | Hersteller |
119
| `name` + `material` | Bezeichnung |
120
| `material` | Materialtyp |
121
| `fill` | Materialuntergruppe (z. B. Glasfaser, Carbon) |
122
| `diameter` | Durchmesser |
123
| `weight` | Rohmaterialgewicht |
124
| `spool_weight` | Standard-Spulengewicht |
125
| `spool_type` | Spulenmaterial |
126
| `density` | Dichte |
127
| `color_hex` / `color_hexes` | Farben (Einzel-/Multicolor) |
128
| `multi_color_direction` | Multicolor-Stil (Gradient/Striped) |
129
| `translucent` / `glow` / `finish` | Oberflächentyp |
130
| `extruder_temp`, `bed_temp` etc. | Zusatzfelder (custom_fields) |
131
132
---
133
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.
134
← [Zurück: Plugin: BambuLab](/Docs/De/14-Plugin-Bambulab) | [Weiter: Plugin: Spoolman API →](/Docs/De/16-Plugin-Spoolmanapi)