> For the complete documentation index, see [llms.txt](https://help.transmutr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.transmutr.com/exporting/command-line-interface.md).

# Command-line interface

{% hint style="success" icon="rocket-launch" %}
**Studio / Creator** feature. The CLI requires a valid Studio or Creator license.
{% endhint %}

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:

<table><thead><tr><th width="200">Platform</th><th>Typical path</th></tr></thead><tbody><tr><td>Windows (per-user)</td><td><code>%LOCALAPPDATA%\Transmutr\current\Transmutr.exe</code></td></tr><tr><td>macOS</td><td><code>/Applications/Transmutr.app/Contents/MacOS/Transmutr</code></td></tr></tbody></table>

{% hint style="info" %}
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.
{% endhint %}

## Basic usage

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

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

Choose an output path:

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

List all flags:

```bash
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:

```bash
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:

```bash
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:

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

{% hint style="warning" %}
Paths and patterns are **case-sensitive**. `.fbx` will not match `.FBX`.
{% endhint %}

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