Spoolman external filament catalog from the Open Filament Database
===================================================================

filaments.json and materials.json in this directory are in the format Spoolman
reads from its external database URL, generated from
https://openfilamentdatabase.org/

USE
---
Point Spoolman at this directory. The trailing slash matters:

  EXTERNAL_DB_URL=https://<this site>/spoolman/
  EXTERNAL_DB_NAME=Open Filament Database      (optional, labels it in the UI)

then restart Spoolman. It re-syncs on an hourly interval.

WHAT THIS IS
------------
One record per purchasable spool (every size of every colour). Ids are
"ofd_<size uuid>", where the uuid is the size's canonical Open Filament Database
uuid, so they stay stable across rebuilds and edits. Spoolman has no alias
concept: if a uuid is ever retired (recorded as "moved_from" on its survivor),
links to the old id will not follow; api/v1/uuid-index.json maps old to current.

Values the database does not record (spool weight, temperatures, ...) are null
rather than guessed. Incomplete products (no density, weight or diameter) are left
out; discontinued products are kept so that existing Spoolman links stay valid. Extruder and bed temperature are resolved the same way as
for the OrcaSlicer presets: the generic temperature of the filament, else of its
brand's material, else the midpoint of the recommended range rounded to 5 degrees
(a range bound of 0 is ignored, not averaged).
Where the build's own defaults stand in for an omitted value (density 1.24,
diameter 1.75, colour black) the default is exported.

Colours: a filament is exported as multi-colour (color_hexes, null color_hex) only
when the database lists two or more colours AND says how they are laid out:
coextruded gives multi_color_direction "coaxial", gradual colour change gives
"longitudinal". Spoolman requires a direction for multi-colour filaments, and the
database also uses colour lists for glow, temperature-change and angle-shift
colours, so a list with no (or both) of those traits cannot be told apart from
them and is exported as single-colour using its first colour.

Names longer than Spoolman's 64-character limit are shortened deterministically:
a trailing parenthetical is dropped if the rest is still unique for that
manufacturer, material, weight and diameter, otherwise the middle is elided.

materials.json holds, per material type, the median density and temperatures
across the exported filaments of that material that record
the value.

Found a wrong number? Corrections are welcome at
https://openfilamentdatabase.org/