Command-line interface

Studio / Creator feature. The CLI requires a valid Studio or Creator license.

The CLI converts models without opening the graphical interface. It is ideal for libraries, CI-style scripts, and LOD pipelines.

Locate the executable

Open a terminal and run the Transmutr executable with the convert subcommand.

Typical locations:

Platform	Typical path
Windows (per-user)	%LOCALAPPDATA%\Transmutr\current\Transmutr.exe
macOS	/Applications/Transmutr.app/Contents/MacOS/Transmutr

Add the install folder to your PATH so you can type a short command instead of the full path. Running the executable without convert opens the GUI.

Basic usage

Convert a model next to the input (same name, .skp):

Transmutr.exe convert C:/models/tree.obj

Choose an output path:

Transmutr.exe convert --output C:/sketchup/mytree.skp C:/models/tree.fbx

List all flags:

Transmutr.exe convert --help

Common options

Option	Description
-o, --output <path>	Output file, or a directory when converting multiple models
-p, --preset <path>	Load a GUI preset .json
--copyMaps	Copy texture maps next to the output
--prefixMaterialsWithModelName	Prefix material names with the model name
--sketchupFileVersion <version>	Target SketchUp .skp version
--scale <x>	Scale multiplier
--sourceUnit <m|cm|mm|f|i>	Source unit
--up <x|y|z|nx|ny|nz>	Up axis
--origin <initial|center|bottomCenter|topCenter>	Output origin
--simplificationLevel <0–1>	Simplification amount
--simplificationAuto	Magic-wand automatic level
--simplificationPreserveNormals / --simplificationPreserveUvs / --simplificationPreserveBorders	Preservation flags
--simplificationTarget <n>	Target face count (CLI-only)
--overwriteInputEdges / --normalAngle / --softenCoplanar / --hideAllEdges	Edge options
--smoothAllEdges / --unsmoothAllEdges	CLI-only edge shortcuts
--exportVrayProxy / --vrayConverterPath	V-Ray proxy
--exportEnscapeProxy / --enscapeConverterPath	Enscape proxy
--proxy <type>	Placeholder type (billboardCross, billboardFaceMe, blobs, boundingBoxWireframe, boundingBoxFaces, faceSkipping, simplifiedGeometry)
--proxyFaceSkippingRatio / --proxySimplificationLevel	Proxy-specific controls
--skipRendererMaterials	Disable V-Ray/Enscape material data

Examples:

Transmutr.exe convert --simplificationLevel 0.25 statue.skp
Transmutr.exe convert --scale 5 --origin bottomCenter models/car.gltf
Transmutr.exe convert --preset C:/presets/studio.json --output C:/out C:/models/*.fbx

Multiple models and globbing

Pass several paths:

Transmutr.exe convert C:/models/tree.fbx C:/models/sofa.obj

Use globs (*, **, ranges). Transmutr expands patterns itself so Windows terminals behave like Unix shells:

Transmutr.exe convert C:/models/trees/*.obj
Transmutr.exe convert C:/models/**/tree.fbx
Transmutr.exe convert C:/models/*.@(obj|fbx)

Paths and patterns are case-sensitive. .fbx will not match .FBX.

When converting multiple models, options apply to all of them, and --output must be a directory.