# Plugin: SpoolmanDB Import

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.

**Installation:** → [Admin: Plugin-Verwaltung](/Docs/De/11-Admin#115-system-plugin-verwaltung)

---

## Übersicht

| Eigenschaft | Wert |
|-------------|------|
| **Plugin-Typ** | Import |
| **Autor** | FilaMan |
| **Quelle** | [Fire-Devils/filaman-plugins](https://github.com/Fire-Devils/filaman-plugins) (Registry) |
| **Datenquelle** | [SpoolmanDB](https://github.com/Donkie/SpoolmanDB) (GitHub) |
| **Fähigkeiten** | Hersteller-Import, Filament-Import, Farben-Import, Durchmesser-Filter |

---

## Was ist die SpoolmanDB?

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:

- Hersteller-Namen
- Filament-Bezeichnungen und Materialtypen
- Farben (Einzel- und Multicolor)
- Durchmesser, Gewicht und Dichte
- Empfohlene Extruder- und Betttemperaturen
- Spulengewicht und Spulenmaterial
- Oberflächen-Eigenschaften (transluzent, leuchtend, etc.)

---

## Import-Seite

Nach der Installation des Plugins finden Sie die Import-Seite unter:

**Admin → System → SpoolmanDB Import**

Die Import-Seite führt Sie in drei Schritten durch den Prozess.

---

## Schritt 1: Importmodus wählen

### Durchmesser-Filter

Vor der Auswahl des Importmodus können Sie optional nach **Durchmesser** filtern:

| Option | Beschreibung |
|--------|-------------|
| **Alle Durchmesser** | Keine Filterung |
| **1.75 mm** | Nur 1.75 mm Filamente (Standard) |
| **2.85 mm** | Nur 2.85 mm Filamente |

### Import-Modi

| Modus | Beschreibung |
|-------|-------------|
| **Alles importieren** | Importiert alle Filamente und Hersteller aus der SpoolmanDB |
| **Nach Hersteller** | Importiert alle Filamente eines bestimmten Herstellers — wählen Sie den Hersteller aus dem Dropdown |
| **Einzelnes Filament** | Importiert ein bestimmtes Filament gezielt — wählen Sie Hersteller (optional als Filter) und Filament aus |

---

## Schritt 2: Vorschau

Nach der Auswahl des Importmodus können Sie eine **Vorschau** laden. Je nach Modus wird angezeigt:

- **Alles importieren:** Gesamtzahl der Hersteller und Filamente
- **Nach Hersteller:** Tabelle mit allen Filamenten des gewählten Herstellers (Name, Material, Durchmesser)
- **Einzelnes Filament:** Detailansicht mit allen verfügbaren Informationen (Hersteller, Name, Material, Durchmesser, Gewicht, Dichte, Farbe, Temperaturen)

> **Tipp:** Prüfen Sie die Vorschau sorgfältig, bevor Sie den Import starten.

---

## Schritt 3: Import ausführen

Klicken Sie auf **„Import starten"**, um die ausgewählten Daten in FilaMan zu importieren.

### Was wird importiert?

| Daten | Beschreibung |
|-------|-------------|
| **Hersteller** | Werden als neue Hersteller in FilaMan angelegt (falls nicht bereits vorhanden) |
| **Filamente** | Werden als neue Filamente mit allen verfügbaren Informationen erstellt |
| **Farben** | Werden als neue Farben in der Farbverwaltung angelegt (falls nicht bereits vorhanden) |

### Duplikat-Erkennung

- **Hersteller** werden anhand des Namens (case-insensitive) erkannt — bereits vorhandene werden übersprungen
- **Filamente** werden anhand der SpoolmanDB-ID erkannt — bereits importierte werden übersprungen
- **Farben** werden anhand des Hex-Codes erkannt — bereits vorhandene werden wiederverwendet

> **Wichtig:** Bestehende Daten in FilaMan werden **nicht** überschrieben oder verändert. Der Import erstellt nur neue Einträge.

### Import-Ergebnis

Nach Abschluss des Imports wird eine Zusammenfassung angezeigt:

| Kategorie | Anzeige |
|-----------|---------|
| **Hersteller** | Anzahl erstellt / übersprungen |
| **Filamente** | Anzahl erstellt / übersprungen |
| **Farben** | Anzahl erstellt / übersprungen |
| **Fehler** | Liste eventueller Fehler (z. B. fehlende Hersteller-Zuordnung) |

---

## Importierte Daten

Die folgenden Filament-Felder werden aus der SpoolmanDB übernommen (sofern vorhanden):

| SpoolmanDB-Feld | FilaMan-Feld |
|-----------------|-------------|
| `manufacturer` | Hersteller |
| `name` + `material` | Bezeichnung |
| `material` | Materialtyp |
| `fill` | Materialuntergruppe (z. B. Glasfaser, Carbon) |
| `diameter` | Durchmesser |
| `weight` | Rohmaterialgewicht |
| `spool_weight` | Standard-Spulengewicht |
| `spool_type` | Spulenmaterial |
| `density` | Dichte |
| `color_hex` / `color_hexes` | Farben (Einzel-/Multicolor) |
| `multi_color_direction` | Multicolor-Stil (Gradient/Striped) |
| `translucent` / `glow` / `finish` | Oberflächentyp |
| `extruder_temp`, `bed_temp` etc. | Zusatzfelder (custom_fields) |

---

← [Zurück: Plugin: BambuLab](/Docs/De/14-Plugin-Bambulab) | [Weiter: Plugin: Spoolman API →](/Docs/De/16-Plugin-Spoolmanapi)
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9