Home A - Z
Page Index

Blame

240011 Manuel Weiser 2026-04-08 20:25:37
docs: Add FilaManDB integration details and update related sections in user manuals
1 
# 18. FilaManDB – Community Database
2
3
**URL (Admin Import):** `http(s)://url/admin/system/filamentdb-import`
4
5
The **FilaManDB** is a public community database at [db.filaman.app](https://db.filaman.app) that contains filament data from numerous manufacturers – including materials, colors, spool profiles, and logos.
6
7
FilaMan offers two ways to use this database:
8
9
1. **Bulk Import** (Admin area) – Import many manufacturers and filaments at once
10
2. **Inline Lookup** (in forms) – Load individual entries directly from the FilaManDB when creating or editing
11
12
> **Prerequisite:** The built-in plugin **"FilamentDB Import"** must be enabled under [Admin → System](/Docs/En/11-Admin). It is a built-in plugin that cannot be uninstalled.
13
14
---
15
16
## 18.1 Bulk Import (Admin Area)
17
18
The bulk import is a **3-step wizard** in the admin area that allows you to import large amounts of manufacturer, filament, and color data from the FilaManDB.
19
20
### Step 1: Select Manufacturers
21
22
1. Click **"Load Preview"** – FilaMan loads the available data from the FilaManDB (manufacturers, materials, colors, filaments, spool profiles)
23
2. A **summary** shows the amount of available data
24
3. Optional: Use the **material filter** to narrow the manufacturer list to specific material types (e.g. only manufacturers offering PLA)
25
4. Select the desired manufacturers via checkboxes
26
- Manufacturers already present in FilaMan are marked with **"Already exists"**
27
- Buttons: **"Select all"**, **"Select all new"** (only new ones), **"Deselect all"**
28
29
### Step 2: Select Filaments
30
31
1. After selecting manufacturers, the associated filaments are loaded
32
2. For each selected manufacturer, the list of available filaments is displayed
33
3. Select the desired filaments via checkboxes
34
35
### Step 3: Import Settings & Execution
36
37
**Spool profile target:** Choose where spool profile information (empty weight, diameter, width, material) should be stored:
38
39
| Option | Description |
40
|--------|-------------|
41
| **On Filament** | Spool data is stored on each filament |
42
| **On Manufacturer** | Spool data is stored once on the manufacturer |
43
| **Both** | Spool data is stored on both the filament and the manufacturer |
44
45
Click **"Start Import"** to execute the import. After completion, a **result summary** is displayed:
46
47
| Category | Display |
48
|----------|---------|
49
| **Manufacturers** | Created / Skipped / Failed |
50
| **Logos** | Downloaded / Failed |
51
| **Colors** | Created / Skipped |
52
| **Filaments** | Created / Skipped / Failed |
53
54
Any warnings or errors that occurred are also displayed.
55
56
---
57
58
## 18.2 Updating Existing Filaments
59
60
If filaments have already been imported and data has changed in the FilaManDB, they can be updated:
61
62
1. Enable the **"Update existing"** toggle in the import wizard
63
2. FilaMan automatically calculates a **diff** (comparison) between the local and current FilaManDB data
64
3. Changes are displayed as a table: **Field Name**, **Current Value**, **New Value**
65
4. Only actually changed filaments will be updated
66
67
---
68
69
## 18.3 Fuzzy Matching
70
71
During import, FilaMan recognizes existing filaments even when the name **differs slightly** (e.g. due to typos, different spellings, or missing special characters).
72
73
**How it works:**
74
- Names are normalized (lowercase, special characters removed) and split into individual words (tokens)
75
- Two names are considered matching if at least **75%** of the tokens overlap
76
- Fuzzy matches are visually highlighted in the import
77
78
> **Example:** "Prusament PLA Galaxy Black" and "Prusament PLA Galaxy-Black 1.75mm" are recognized as matching.
79
80
---
81
82
## 18.4 Inline Lookup in Forms
83
84
In addition to the bulk import, FilaMan also allows you to **load individual entries directly in forms** from the FilaManDB. This feature is available on the following pages:
85
86
### Creating / Editing Manufacturers
87
88
When creating a new manufacturer, you can choose between two modes:
89
- **"Create from FilaManDB"** – Search the community database and import name, website, and logo
90
- **"Manual entry"** – Enter the data manually as before
91
92
When **editing** an existing manufacturer, the **"Load from FilaManDB"** button is also available to update the data.
93
94
→ See [Chapter 5: Manufacturers](/Docs/En/05-Manufacturers)
95
96
### Creating / Editing Filaments
97
98
After selecting a manufacturer, the **"Load from FilaManDB"** button appears. With it you can:
99
- Search for a filament in the community database
100
- All fields are automatically pre-filled (designation, material, diameter, colors, price, etc.)
101
- If the manufacturer or colors do not yet exist locally, they are automatically created
102
103
→ See [Chapter 6: Filaments](/Docs/En/06-Filaments)
104
105
### Creating / Editing Spools
106
107
When creating or editing a spool, the **"Load from FilaManDB"** button is available for **spool profile data**:
108
- Search for a spool profile (e.g. by manufacturer or material)
109
- Empty weight, diameter, and width are automatically applied
110
- If available, an image of the spool profile is displayed
111
112
→ See [Chapter 7: Spools](/Docs/En/07-Spools)
113
114
---
115
116
> **Note:** All FilaManDB buttons and features are only displayed when the FilamentDB plugin is enabled under [Admin → System](/Docs/En/11-Admin).
117
118
---
119
120
← [Back: Plugin: Bambuddy](/Docs/En/17-Plugin-Bambuddy) | [Next: Installation on Raspberry Pi →](/Docs/En/20-Installation-Raspberry-Pi)