Loading models into your library

To turn the pile of files on disk into a beautiful gallery of models, we scan your disk and based on your descriptions of it's contents, build the models library.

Adding new local sources


A "local source" is a folder on a local or networked hard drive. You may have more than one source, local or otherwise.

Importing models from your disk

<Icon className={"confirm"} icon={faRightToBracket} title={"import"} /> will run the importer based on the configured settings.

The importer takes about 1s per 1000 files on a standard SSD. It will take a little longer over a network!

Configuring the importer

The importer searches through your folders, one at a time, from the given source directory and performs the following actions:

  1. Model creation: check if this folder should be a model, and decide which files to add to it.

  2. System tag creation: configure any system tags, based on inheritance

A. Model creation

When processing a folder, there are three stages. The first two stages are used to decide if it should be turned into a model, and the third determines what to do with the files in that folder.

  1. Configuration handling
  2. Model creation rules
  3. File handling

1. Configuration handling

This determines if a folder has the possibility of being a model.

  • <Icon className={"alt-accent"} icon={faAnglesUp} title={"inherit"} />

    Inherit: use the parent settings to process this folder

  • <Icon className={"alt-accent"} icon={faBan} title={"disabled"} />

    Disabled: don't make this folder a model

  • <Icon className={"alt-accent"} icon={faCheck} title={"enabled"} />

    Enabled: make this folder a model if criteria are met

2. Model creation rules

If the configuration is set to

<Icon className={"alt-accent"} icon={faCheck} /> (enabled), then this folder could become a model, based on the following configured criteria. If the configuration is set to <Icon className={"alt-accent"} icon={faAnglesUp} title={"inherit"} /> (inherit), the model creation rules are disabled for this folder, and they will use the parent's configuration.

  • <Icon className={"alt-accent"} icon={faAsterisk} title={"always"} />

    Always: create a model no matter what

  • <Icon className={"alt-accent"} icon={faLeaf} title={"leaf"} />

    Leaf: the folder must not have other folders in it.

  • <Icon className={"alt-accent"} icon={faImage} title={"has image"} />

    Has image: the folder must contain an image: PNG, JP(E)G, GIF

  • <Icon className={"alt-accent"} icon={faCube} title={"has 3D file"} />

    Has 3D file: the folder must contain a 3D file: STL, 3MF, OBJ

  • <Icon className={"alt-accent"} icon={faPencilRuler} title={"has support config"} />

    Has support config: the folder must contain a support configuration file: LYS, LYT, CHITU

3. File handling

For every file found, you may configure how the files are handled. This can be set to one of two choices:

  • <Icon className={"alt-accent"} icon={faArrowsToDot} title={"collect here"} />

    Here: only collect files found in the procesed folder.

  • <Icon className={"alt-accent"} icon={faArrowsSplitUpAndLeft} title={"collect below"} />

    Below: collect files found in the procesed folder, as well as files found in descendent folders that are not already part of another model.

Note: model creation rules only operate on files directly within that folder. This means setting

<Icon className={"alt-accent"} icon={faArrowsSplitUpAndLeft} title={"collect below"} /> (collect below) will not recheck your model creation rules.

B. System tag creation##

Tags can be added to a model during the import process, and are inheritable. The three options available under the

<Icon className={"emphasis"} icon={faTags} title={"tags"} /> (tags) menu are:

  1. Don't inherit any parent tags - any currently inherited tags will be removed from this model (and thus not be inherited by models below, either).

  2. Exclude the following system tags - remove these tags from models created from this point.

  3. Include new system tags - add these tags to models that are created from this point.

The tag inheritance process runs regardless of if a given folder is determined to be a model. You can set a folder to

<Icon className={"alt-accent"} icon={faBan} title={"disabled"} /> (disabled) but configure tags to include or exclude from this point forward.

User Tags can be manually added to individual models after importing in the Explore view. These are "user tags", and aren't part of the system tag creation.

Folder functions

  • <Icon className={"accent"} icon={faSave} title={"save"} />

    Save configuration

  • <Icon className={"accent"} icon={faRefresh} title={"revert"} />

    Revert changes

  • <Icon className={"confirm"} icon={faRightToBracket} title={"import"} />

    Run the importer based on the configured settings

Managing your sources

Extra source management functions may be accessed behind

<Icon className={"accent"} icon={faEllipsisV} title={"Source menu"} />

  • <Icon className={"accent"} icon={faRightToBracket} title={"Backup user.json files"} />

    Backup user.json files - collect user.json files in your local source and create a zip file.

  • <Icon className={"danger"} icon={faBan} title={"Clear these models"} /><DangerText>Clear these models</DangerText>
    • remove any models in your library created by the importer from this source.
  • <Icon className={"danger"} icon={faClose} title={"Remove local source"} /><DangerText>Remove local source</DangerText>
    • remove this source from your library (also removes models created by this source)