# Plugin: SpoolmanDB Import 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. **Installation:** → [Admin: Plugin Management](/Docs/En/11-Admin#115-system-plugin-management) --- ## Overview | 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 | --- ## What is SpoolmanDB? [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.) --- ## 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) | --- ← [Back: Plugin: BambuLab](/Docs/En/14-Plugin-Bambulab) | [Next: Plugin: Spoolman API →](/Docs/En/16-Plugin-Spoolmanapi)