Skip to main content

Model Library & 3MF Parsing

The Model Library stores your printable files and extracts rich metadata from .3mf files automatically. Uploading a .3mf gives you print time estimates, filament usage, a thumbnail, and an object checklist — no manual entry required.

Uploading Models​

Navigate to Models → Library → Upload or drag-and-drop files onto the Library page.

Supported formats:

  • .3mf — full metadata extraction (see below)
  • .gcode — stored as-is, no metadata extraction

Multiple files can be uploaded simultaneously.

3MF Metadata Extraction​

When a .3mf file is uploaded, O.D.I.N. parses it and extracts:

  • Estimated print time — from slicer metadata
  • Filament usage — grams per material type used
  • Target printer model — from slicer settings
  • Thumbnail — embedded preview image (shown on model cards)
  • Object checklist — list of individual objects in the build plate
  • Wipe tower — auto-identified and unchecked from the object list
  • Plate count — number of build plates in multi-plate 3MF files
  • Layer count and layer height
  • Nozzle diameter
  • Bed type

The quantity_per_bed value is calculated from the checked objects in the object checklist and persisted.

Multi-Plate 3MF Support​

Some slicers (Bambu Studio, OrcaSlicer) produce multi-plate .3mf files where each plate is a separate print job.

When scheduling a job from a multi-plate model, a plate selector lets you choose which plate to print. Each plate has its own thumbnail and metadata. The plate_count field is exposed via the variants endpoint.

File Duplicate Detection​

O.D.I.N. computes a SHA-256 hash of each uploaded file.

  • On upload, if the hash matches an existing file, the upload response includes a duplicate warning with the existing file's ID and name
  • You can still save the file as a new model entry, or discard the upload and use the existing model

Library Management​

The Model Library supports:

  • Search — by name, material type, or tag
  • Favorites — star frequently-used models; filter by favorites
  • Stat cards — total model count, total estimated print hours, most-printed model

Per-model actions:

  • Schedule — create a new job directly from the model card
  • Quick Print — schedule immediately with default settings
  • Edit — update name, description, filament type, tags, org assignment
  • Delete — removes the model (admin only)
  • History — view revision history

Model Versioning (v1.3.0+)​

Added in v1.3.0

Model versioning is available from v1.3.0 onwards.

Each model maintains a revision history. When you upload a new version of a model:

  1. Open the model detail
  2. Click Upload New Revision
  3. Select the updated .3mf or .gcode file
  4. Enter an optional changelog note (what changed in this version)
  5. The revision is saved with a version number, upload date, and uploader

Revision history is visible via the History button on model cards. You can browse all past revisions but cannot revert automatically — download an older revision's file and re-upload if needed.

Quick Print​

The Quick Print button on the upload success screen (and on model cards) creates a pending job immediately with default settings — no scheduling wizard required. Useful for one-off prints.

See Also​