Plugin: SpoolmanDB Import
The SpoolmanDB Import Plugin allows you to import filament data from the SpoolmanDB community database directly into FilaMan. SpoolmanDB is an open, community-maintained database containing filament information from numerous manufacturers.
Installation: → Admin: Plugin Management
Overview
| Property | Value |
|---|---|
| Plugin Type | Import |
| Author | FilaMan |
| Source | Fire-Devils/filaman-plugins (Registry) |
| Data Source | SpoolmanDB (GitHub) |
| Capabilities | Manufacturer import, Filament import, Color import, Diameter filter |
What is SpoolmanDB?
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.)
Import Page
After installing the plugin, you can find the import page at:
Admin → System → SpoolmanDB Import
The import page guides you through the process in three steps.
Step 1: Choose Import Mode
Diameter Filter
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 |
Import Modes
| 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 |
Step 2: Preview
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)
Tip: Review the preview carefully before starting the import.
Step 3: Execute Import
Click "Start Import" to import the selected data into FilaMan.
What Gets Imported?
| 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) |
Duplicate Detection
- 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
Important: Existing data in FilaMan is never overwritten or modified. The import only creates new entries.
Import Result
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) |
Imported Data
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) |