> 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/v2-de/exportieren/command-line-interface.md).

# Befehlszeile

{% hint style="success" icon="rocket-launch" %}
**Funktion von Studio / Creator.** Die Befehlszeile erfordert eine gültige Lizenz für Studio oder Creator.
{% endhint %}

Die Befehlszeile konvertiert Modelle, ohne die grafische Oberfläche zu öffnen. Sie eignet sich für Bibliotheken, CI-ähnliche Skripte und LOD-Pipelines.

## Die Programmdatei finden

Öffnen Sie ein Terminal und starten Sie die Transmutr-Programmdatei mit dem Unterbefehl `convert`.

Übliche Speicherorte:

<table><thead><tr><th width="200">Plattform</th><th>Üblicher Pfad</th></tr></thead><tbody><tr><td>Windows (pro Benutzer)</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" %}
Fügen Sie den Installationsordner zu Ihrem `PATH` hinzu, damit Sie einen kurzen Befehl statt des vollständigen Pfads eingeben können. Wenn Sie die Programmdatei **ohne** `convert` starten, öffnet sich die Benutzeroberfläche.
{% endhint %}

## Grundlegende Verwendung

Ein Modell neben der Eingabe konvertieren (gleicher Name, `.skp`):

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

Ausgabepfad wählen:

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

Alle Optionen auflisten:

```bash
Transmutr.exe convert --help
```

## Häufige Optionen

| Option                                                                                                | Beschreibung                                                                                                                                    |
| ----------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `-o, --output <path>`                                                                                 | Ausgabedatei oder ein Verzeichnis, wenn mehrere Modelle konvertiert werden                                                                      |
| `-p, --preset <path>`                                                                                 | Eine Preset-Datei `.json` aus der Oberfläche laden                                                                                              |
| `--copyMaps`                                                                                          | Textur-Maps neben die Ausgabe kopieren                                                                                                          |
| `--prefixMaterialsWithModelName`                                                                      | Materialnamen den Modellnamen voranstellen                                                                                                      |
| `--sketchupFileVersion <version>`                                                                     | Zielversion der SketchUp-Datei `.skp`                                                                                                           |
| `--scale <x>`                                                                                         | Skalierungsfaktor                                                                                                                               |
| `--sourceUnit <m\|cm\|mm\|f\|i>`                                                                      | Quelleinheit                                                                                                                                    |
| `--up <x\|y\|z\|nx\|ny\|nz>`                                                                          | Hochachse                                                                                                                                       |
| `--origin <initial\|center\|bottomCenter\|topCenter>`                                                 | Ursprung der Ausgabe                                                                                                                            |
| `--simplificationLevel <0–1>`                                                                         | Grad der Vereinfachung                                                                                                                          |
| `--simplificationAuto`                                                                                | Automatische Stufe per Zauberstab                                                                                                               |
| `--simplificationPreserveNormals` / `--simplificationPreserveUvs` / `--simplificationPreserveBorders` | Schalter zum Beibehalten                                                                                                                        |
| `--simplificationTarget <n>`                                                                          | Zielanzahl der Flächen (nur CLI)                                                                                                                |
| `--overwriteInputEdges` / `--normalAngle` / `--softenCoplanar` / `--hideAllEdges`                     | Kantenoptionen                                                                                                                                  |
| `--smoothAllEdges` / `--unsmoothAllEdges`                                                             | Kanten-Kurzbefehle nur für die CLI                                                                                                              |
| `--exportVrayProxy` / `--vrayConverterPath`                                                           | V-Ray-Proxy                                                                                                                                     |
| `--exportEnscapeProxy` / `--enscapeConverterPath`                                                     | Enscape-Proxy                                                                                                                                   |
| `--proxy <type>`                                                                                      | Platzhaltertyp (`billboardCross`, `billboardFaceMe`, `blobs`, `boundingBoxWireframe`, `boundingBoxFaces`, `faceSkipping`, `simplifiedGeometry`) |
| `--proxyFaceSkippingRatio` / `--proxySimplificationLevel`                                             | Proxy-spezifische Einstellungen                                                                                                                 |
| `--skipRendererMaterials`                                                                             | Materialdaten von V-Ray/Enscape deaktivieren                                                                                                    |

Beispiele:

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

## Mehrere Modelle und Globs

Mehrere Pfade übergeben:

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

Verwenden Sie Globs (`*`, `**`, Bereiche). Transmutr expandiert die Muster selbst, sodass sich Windows-Terminals wie Unix-Shells verhalten:

```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" %}
Bei Pfaden und Mustern wird die **Groß-/Kleinschreibung unterschieden**. `.fbx` entspricht nicht `.FBX`.
{% endhint %}

Wenn Sie mehrere Modelle konvertieren, gelten die Optionen für alle, und `--output` muss ein **Verzeichnis** sein.