SolidlyDocs
Command line

The solidly command

Solidly ships a standalone solidly executable that does two things: it opens a model in the application, and it renders images using the same renderer the application uses.

Direct download only

The command line tool is not included in the Mac App Store build. See The two distributions.

Installing

The signed executable is inside the application bundle at Solidly.app/Contents/Helpers/solidly. Link it into a directory on your PATH to make it available under that name:

sudo ln -sf "/Applications/Solidly.app/Contents/Helpers/solidly" /usr/local/bin/solidly

Shape

solidly <model>
solidly render <file-or-folder> [options]

A bare model path opens that file in Solidly, exactly as opening it from the Finder would.

Help and version

solidly --help
solidly render --help
solidly --version

What it accepts

<file-or-folder> may be:

  • a single .gltf, .glb, .fbx, .obj, .stl, .ply, .usd, .usda, .usdc, or .usdz file
  • a folder containing a model and its sibling files
  • a folder containing many models
  • a folder of subfolders containing models

Folder scanning follows the same rules as the application, described in Opening files and folders.

Rendering

solidly render ~/Models --output ~/Renders --preset front --resolution 3840x2160

Every render setting is an ordinary command line option, so a complete invocation can be kept in a shell script. solidly render is the full option reference.

The renderer enforces the same import memory limit the application does. A model that would exceed it is reported as a failure for that file, and the run continues with the next one.