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.

---

| Property | Value |

|----------|-------|

| **Plugin Type** | Import |

| **Author** | FilaMan |

| **Source** | [Fire-Devils/filaman-plugins](https://github.com/Fire-Devils/filaman-plugins) (Registry) |

| **Data Source** | [SpoolmanDB](https://github.com/Donkie/SpoolmanDB) (GitHub) |

| **Capabilities** | Manufacturer import, Filament import, Color import, Diameter filter |

---

[SpoolmanDB](https://github.com/Donkie/SpoolmanDB) is a community-maintained open-source database containing filament information from many manufacturers. It includes:

- Manufacturer names

- Filament names and material types

- Colors (single and multi-color)

- Diameter, weight, and density

- Recommended extruder and bed temperatures

- Spool weight and spool material

- Surface properties (translucent, glow, etc.)

---

After installing the plugin, you can find the import page at:

The import page guides you through the process in three steps.

---

Before selecting the import mode, you can optionally filter by **diameter**:

| Option | Description |

|--------|-------------|

| **All diameters** | No filtering |

| **1.75 mm** | Only 1.75 mm filaments (default) |

| **2.85 mm** | Only 2.85 mm filaments |

| Mode | Description |

|------|-------------|

| **Import all** | Imports all filaments and manufacturers from SpoolmanDB |

| **By manufacturer** | Imports all filaments from a specific manufacturer — select the manufacturer from the dropdown |

| **Single filament** | Imports a specific filament — select manufacturer (optional filter) and filament |

---

After selecting the import mode, you can load a **preview**. Depending on the mode, it shows:

- **Import all:** Total count of manufacturers and filaments

- **By manufacturer:** Table listing all filaments from the chosen manufacturer (name, material, diameter)

- **Single filament:** Detail view with all available information (manufacturer, name, material, diameter, weight, density, color, temperatures)

---

Click **"Start Import"** to import the selected data into FilaMan.

| Data | Description |

|------|-------------|

| **Manufacturers** | Created as new manufacturers in FilaMan (if not already present) |

| **Filaments** | Created as new filaments with all available information |

| **Colors** | Created as new colors in color management (if not already present) |

- **Manufacturers** are matched by name (case-insensitive) — existing ones are skipped

- **Filaments** are matched by SpoolmanDB ID — previously imported ones are skipped

- **Colors** are matched by hex code — existing ones are reused

After the import completes, a summary is displayed:

| Category | Display |

|----------|---------|

| **Manufacturers** | Count created / skipped |

| **Filaments** | Count created / skipped |

| **Colors** | Count created / skipped |

| **Errors** | List of any errors (e.g. missing manufacturer assignment) |

---

The following filament fields are imported from SpoolmanDB (if available):

| SpoolmanDB Field | FilaMan Field |

|-----------------|---------------|

| `manufacturer` | Manufacturer |

| `name` + `material` | Designation |

| `material` | Material type |

| `fill` | Material subgroup (e.g. glass fiber, carbon) |

| `diameter` | Diameter |

| `weight` | Raw material weight |

| `spool_weight` | Default spool weight |

| `spool_type` | Spool material |

| `density` | Density |

| `color_hex` / `color_hexes` | Colors (single/multi-color) |

| `multi_color_direction` | Multi-color style (gradient/striped) |

| `translucent` / `glow` / `finish` | Finish type |

| `extruder_temp`, `bed_temp` etc. | Extra fields (custom_fields) |

---