> For the complete documentation index, see [llms.txt](https://docs.sannybuilder.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sannybuilder.com/editor/cli.md).

# Command Line Interface

## --compile

`--compile <input file path> [output file path]` - compiles the file and exits

```
sanny.exe --compile C:\myscm.txt C:\myscm.scm
```

{% hint style="info" %}
The `output file path` parameter is optional. If there is no output path parameter, the compiler uses the [format rules](https://github.com/sannybuilder/docs/blob/en/editor/broken-reference/README.md) to compute the output file name.
{% endhint %}

{% hint style="info" %}
The input file must have no errors. If there are errors found during compilation, they will be logged in the file `compile.log`. When compilation ends, the program shuts down.
{% endhint %}

Shortcut: `-c`

## --decompile

`--decompile <input file path> [output file path]` - decompiles the file and exits

```
sanny.exe --decompile C:\myscm.scm C:\myscm.txt
```

{% hint style="info" %}
The `output file path` parameter is optional. If there is no output path parameter, the compiler uses the [format rules](https://github.com/sannybuilder/docs/blob/en/editor/broken-reference/README.md) to compute the output file name.
{% endhint %}

{% hint style="info" %}
The input file must have no errors. If there are errors found during decompilation, they will be logged in the file `compile.log`. When decompilation ends, the program shuts down.
{% endhint %}

Shortcut: `-d`

**--use-source** - optional argument that makes the decompiler use the source code [embedded in the script](/editor/options/general.md#add-extra-info-to-scm) (if present). By default the source is ignored.

```
sanny.exe --decompile C:\1.cs --use-source
```

## --debug

`--debug` - toggles [debug options](/editor/debug-options.md)

```
sanny.exe --debug 110000
```

## --game

`--game <game>` - selects the [default mode](/edit-modes.md#type) for the given game. Known `game` values are:

* `gta3`
* `vc`
* `sa`
* `lcs`
* `vcs`
* `vc_mobile`
* `sa_mobile`

Shortcut: `-g`

```
sanny.exe --game sa
```

## --mode

`--mode <id>` - selects the mode by `id`. [Modes](/edit-modes.md) and their ids are defined in respective `mode.xml` files.

Shortcut: `-m`

```
sanny.exe --mode vcs_psp
```

## --no-splash

`--no-splash` - runs Sanny Builder without the splash screen

```
sanny.exe --no-splash
```

## -x

`-x` - reloads [edit modes](/edit-modes.md) configuration (useful for testing the mode changes)

```
sanny.exe -x
```

## --option

{% hint style="info" %}
Available since v3.8.0
{% endhint %}

`-o <option name> <value>` - sets the value of the specified [option](/editor/options.md). To set multiple options, list each of them individually:

`-o <option1 name> <option1 value> -o <option2 name> <option2 value> ... -o <optionN name> <optionN value>`

Option name can be one of the following:

{% hint style="warning" %}
This list is not final and subject to change at any moment.
{% endhint %}

| Name                                                                                                              | Allowed Values  | Options Tab |
| ----------------------------------------------------------------------------------------------------------------- | --------------- | ----------- |
| [Editor::ShowPanel](/editor/options/editor.md#editor-configuration)                                               | 0, 1            | Editor      |
| [Editor::ShowOpcodeInfo](/editor/options/editor.md#editor-configuration)                                          | 0, 1            | Editor      |
| [Editor::ShowLineNumbers](/editor/options/editor.md#editor-configuration)                                         | 0, 1            | Editor      |
| [Editor::ShowGutterBorder](/editor/options/editor.md#editor-configuration)                                        | 0, 1            | Editor      |
| [Editor::OpenLastFile](/editor/options/editor.md#editor-configuration)                                            | 0, 1            | Editor      |
| [Editor::OpenAllClosedFiles](/editor/options/editor.md#editor-configuration)                                      | 0, 1            | Editor      |
| [Editor::ConfirmExit](/editor/options/editor.md#editor-configuration)                                             | 0, 1            | Editor      |
| [Editor::LanguageService](/editor/options/editor.md#editor-configuration)                                         | 0, 1            | Editor      |
| [Editor::SemanticConstHighlighting](/editor/options/editor.md#editor-configuration)                               | 0, 1            | Editor      |
| [Editor::IdentifiersListAuto](/editor/options/editor.md#code-scan-distance)                                       | 0, 1            | Editor      |
| [Editor::ScanDistance](/editor/options/editor.md#code-scan-distance)                                              | 0..65535        | Editor      |
| [Editor::Lang](/editor/options/general.md#interface-language)                                                     | known locale id | General     |
| [Editor::QuickGameLoading](/editor/options/general.md#quick-game-loading)                                         | 0, 1            | General     |
| [Editor::ShowProgress](/editor/options/general.md#show-progress)                                                  | 0, 1            | General     |
| [Editor::ShowReport](/editor/options/general.md#show-report)                                                      | 0, 1            | General     |
| [Decompiler::OverwriteOutputFile](/editor/options/general.md#always-overwrite-output-file)                        | 0, 1            | General     |
| [Decompiler::ManualIMGOpening](/editor/options/general.md#manual-img-opening)                                     | 0, 1            | General     |
| [Decompiler::HexadimalOffsets](https://github.com/sannybuilder/docs/blob/en/editor/broken-reference/README.md)    | 0, 1            | Formats     |
| [Decompiler::LabelsFormat](https://github.com/sannybuilder/docs/blob/en/editor/broken-reference/README.md)        | 0, 1, 2         | Formats     |
| [Decompiler::AlwaysWriteOpcodes](/editor/options/general.md#write-opcodes)                                        | 0, 1            | General     |
| [Decompiler::ReplaceMissionNumbers](/editor/options/general.md#replace-mission-numbers)                           | 0, 1            | General     |
| [Decompiler::InsertOriginalMissionNames](/editor/options/general.md#insert-original-mission-names)                | 0, 1            | General     |
| [Compiler::ShowIMGWarning](/editor/options/general.md#show-warning)                                               | 0, 1            | General     |
| [Compiler::CheckConditions](/editor/options/general.md#check-conditions)                                          | 0, 1            | General     |
| [Compiler::CheckLocalVariables](/editor/options/general.md#ranges-check)                                          | 0, 1            | General     |
| [Compiler::AddExtraInfo](/editor/options/general.md#add-extra-info-to-scm)                                        | 0, 1            | General     |
| [CustomNames::UseCustomLabels](https://github.com/sannybuilder/docs/blob/en/editor/broken-reference/README.md)    | 0, 1            | Formats     |
| [CustomNames::UseCustomVariables](https://github.com/sannybuilder/docs/blob/en/editor/broken-reference/README.md) | 0, 1            | Formats     |
| [CustomNames::UseCustomArrays](https://github.com/sannybuilder/docs/blob/en/editor/broken-reference/README.md)    | 0, 1            | Formats     |
| [CustomNames::Format](https://github.com/sannybuilder/docs/blob/en/editor/broken-reference/README.md)             | 0, 1, 2         | Formats     |

{% hint style="info" %}
Options set via CLI are not persistent and only applied to the current session. On the next launch Sanny Builder will use values stored in the `settings.ini`.
{% endhint %}

Shortcut: `-o`

```
sanny.exe -o Compiler::CheckConditions 0 -o Editor::LanguageService 1
```