SpoolmanDB Community

Loading filament and material data...

Community-Driven Project

Find filament data before it reaches your spool shelf.

Access thousands of source-backed filament profiles, manufacturers, materials, and technical documents. It integrates seamlessly with your Spoolman instance for precise inventory tracking.

Open Database Explorer
https://icezaza2543.github.io/SpoolmanDB-Community/
Total variants -
Manufacturers -
Catalog / defaults -
Multi-color rows -
Rows with product IDs -
Rows with TDS / SDS -

Quick Resources

Open Explorer Browse the full catalog with advanced filters for diameter, weight, and color variants. Launch Catalog filaments.json Raw filament definitions for manual ingestion. Download materials.json Standard material properties and density data. Download

Support community efforts

Missing a manufacturer? Found an error in a material density? Learn how to submit a Pull Request to our GitHub repository.

How to contribute
Built on the project stack
Static HTML CSS Vanilla JS ECharts JSON Schema

Analytics

Explore global filament material trends and insights from the community catalog.

Database Knowledge Vault

Live catalog graph

Material Mix

Catalog composition

Top Manufacturers

Highest variant counts

Database Coverage

Metadata completeness

Color Spectrum Map

HSL cluster distribution

Packaging Distribution

Packaging adoption

Spoolman Static Index

Based on the compiled Spoolman-compatible catalog, these charts summarize real community data from the published JSON files.

Inspect rows

Database Explorer

Waiting for data...

No filters applied.

Color Manufacturer Filament Name Material Diameter Weight Packaging Temps TDS
Loading...

SpoolmanDB Static Index

This is a global static mirror of community-contributed filament data. Copy the external database URL to link this catalog to your personal Spoolman instance.

Schemas & Quality

Standardizing the global filament ledger with technical precision.

Conceptual Data Relationships

Conceptual diagram only: the tables and relationship IDs below illustrate catalog concepts, not the JSON storage format. Fields such as manufacturer_id, material_id, and spool_type_id are illustrative, not published JSON fields.

Source files contain manufacturer and filaments, with nested weights, diameters, and colors. Published filaments.json is a flat array of records with id, manufacturer, material, diameter, weight, and packaging metadata. Use the live schema viewer below for the exact source, compiled, and material-default fields.

Export JSON Edit Schema
MANUFACTURERS
manufacturer_id string
name string
MATERIALS
material_id string
material string
density float
extruder_temp integer
bed_temp integer
FILAMENTS
filament_id string
name string
manufacturer_id string
material_id string
density float
diameter_id string
weight_id string
color_id string
extruder_temp integer
bed_temp integer
DIAMETERS
diameter_id string
diameter float
COLORS
color_id string
name string
hex string
finish enum
translucent boolean
glow boolean
WEIGHTS_SPOOLS
weight_id string
weight float
spool_weight float
spool_type_id string
is_refill boolean
SPOOL_TYPES
spool_type_id string
type_name string

Data Quality Health

Quality status -

Waiting for data...

Severity Type Filament Detail
Waiting for data...

Live JSON Schema Viewer

Loading schemas...

Open schema JSON filaments.schema.json
Root type -
Path Constraint Validation rule Notes
Loading schema fields...
Grow the Filament Registry

Grow the Filament Registry

SpoolmanDB thrives on technical precision and shared knowledge. Help thousands of makers by contributing accurate data for filament materials and brands.

Official Repository

Access the raw JSON database and start contributing through GitHub.

Open Repository
1

Pick the source file

Locate the relevant manufacturer file within the filaments/ directory of the repository.

Local Setup 
$ git clone https://github.com/Icezaza2543/SpoolmanDB-Community.git
$ cd SpoolmanDB-Community
2

Edit source JSON

Add or update filament entries in the relevant manufacturer JSON file. Follow the existing structure and provide accurate data.

3

Validate locally

Use the local tools to compile and validate your changes against the official schemas before committing.

Local commands 
# Install dependencies
$ pip install -r requirements-dev.txt
# Refresh generated README metrics
$ python scripts/readme_snapshot.py --write
# Run compiler
$ python scripts/compile_filaments.py
# Only for verified new variants: enroll their public IDs
$ python scripts/compile_id_baseline.py --update

Skip enrollment when no identities were added. Inspect the baseline diff: only the intended new identities may be added; never change or remove historical entries or use a breaking-change override.

# Compare with the target branch and require exact baseline synchronization
$ python scripts/compile_id_baseline.py --strict --base-ref origin/main
# Validate source and compiled data
$ python scripts/validate.py --strict
# Verify generated README metrics
$ python scripts/readme_snapshot.py --check
# Run regression tests
$ python -m pytest -q
# Check the pinned Spoolman contract
$ python scripts/check_spoolman_compat.py --mode stable
# Advisory check against current Spoolman master
$ python scripts/check_spoolman_compat.py --mode canary
# Verify the strict Spoolman projection
$ python scripts/project_spoolman.py
# Review whitespace and the intended file changes
$ git diff --check
$ git status --short
4

Open a PR

Submit your changes for review. Ensure your pull request follows the checklist below for a smooth approval process.

Submit Pull Request Review timing depends on maintainer availability and the evidence needed.

Source finder

Need to find specific filament details? Search the loaded catalog by manufacturer and jump into repository code search.

  • Type a manufacturer name to see matches.
Need Help? README Open issue