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

# CLI Exit Codes

The VIESUS CLI is a wrapper around the IsEnhance library. It returns the library's return code offset by **−100** — e.g., CLI exit code `-104` corresponds to library error `-4` (missing parameter file). Exit code `0` means success. The tables below list the **library return codes**; subtract 100 from a code to get the CLI exit code.

For PDF Enhancer error codes, see [PDF Error Codes](/support/error-codes/pdf.md). For symptom-based troubleshooting, see [Troubleshooting → CLI](/support/troubleshooting.md#cli-and-image-enhancement).

<button type="button" class="button secondary" data-action="ask" data-query="What does VIESUS CLI exit code ___ mean, and how do I fix it?" data-icon="gitbook-assistant">Explain an exit code</button>

***

<details>

<summary><strong>Common license-related fixes</strong></summary>

* **Feature not licensed** (codes `-50` to `-62`) — confirm the AI features you're using are included in your license with <info@viesus.com>.
* **GUID error** (codes `-90` to `-95`) — verify the GUID is correct and the DLL version matches the install.

</details>

<details>

<summary><strong>General errors (-1 to -20)</strong></summary>

<table><thead><tr><th width="170">Code</th><th>Description</th></tr></thead><tbody><tr><td>-1</td><td>Enhancement object initialisation failed</td></tr><tr><td>-2</td><td>Incorrect memory organisation</td></tr><tr><td>-3</td><td>Enhancement validation failed</td></tr><tr><td>-4</td><td>Required filename parameter missing</td></tr><tr><td>-5</td><td>Failed to load INI/JSON configuration file</td></tr><tr><td>-6</td><td>Failed to save INI/JSON configuration file</td></tr><tr><td>-7</td><td>Invalid image pointer</td></tr><tr><td>-8</td><td>Invalid image data pointer</td></tr><tr><td>-9</td><td>Invalid processing parameters pointer</td></tr><tr><td>-10</td><td>Generic null pointer error</td></tr><tr><td>-11</td><td>Missing image enhancement analysis</td></tr><tr><td>-12</td><td>Failed to load ICC color profile</td></tr><tr><td>-13</td><td>Failed to retrieve license information</td></tr><tr><td>-14</td><td>Image already enhanced (use <code>-a</code> to force)</td></tr><tr><td>-15</td><td>Color management system analysis failed</td></tr><tr><td>-16</td><td>Resize analysis failed</td></tr><tr><td>-17</td><td>Resize region of interest out of limits</td></tr><tr><td>-18</td><td>Pre-processing analysis failed</td></tr><tr><td>-19</td><td>Face detection analysis failed</td></tr><tr><td>-20</td><td>Noise reduction analysis failed</td></tr></tbody></table>

</details>

<details>

<summary><strong>Processing errors (-21 to -49)</strong></summary>

<table><thead><tr><th width="170">Code</th><th>Description</th></tr></thead><tbody><tr><td>-21</td><td>Noise reduction processing failed</td></tr><tr><td>-22</td><td>Red-eye reduction analysis failed</td></tr><tr><td>-23</td><td>Red-eye reduction processing failed</td></tr><tr><td>-24</td><td>Global balance processing failed</td></tr><tr><td>-25</td><td>Sharpening processing failed</td></tr><tr><td>-26</td><td>Resize processing failed (check SR model)</td></tr><tr><td>-27</td><td>Incorrect data type provided</td></tr><tr><td>-28</td><td>Red-eye region processing failed</td></tr><tr><td>-29</td><td>Incorrect color channel order</td></tr><tr><td>-30</td><td>ICC profile validation failed</td></tr><tr><td>-31</td><td>Memory allocation failed</td></tr><tr><td>-32</td><td>Color conversion to sRGB failed</td></tr><tr><td>-33</td><td>Color conversion from sRGB failed</td></tr><tr><td>-34</td><td>Operation not supported</td></tr><tr><td>-35</td><td>Temporary color transform failed</td></tr><tr><td>-36</td><td>GGA processing failed</td></tr><tr><td>-37</td><td>AI upscaling resize failed</td></tr><tr><td>-45</td><td>Face reconstruction analysis failed</td></tr><tr><td>-46</td><td>Face reconstruction processing failed</td></tr><tr><td>-47</td><td>Background analysis failed</td></tr><tr><td>-48</td><td>Background processing failed</td></tr><tr><td>-49</td><td>Face blur processing failed</td></tr></tbody></table>

</details>

<details>

<summary><strong>Scene, crop &#x26; AI processing errors (-96 to -103)</strong></summary>

<table><thead><tr><th width="170">Code</th><th>Description</th></tr></thead><tbody><tr><td>-96</td><td>Scene-detection analysis failed</td></tr><tr><td>-97</td><td>Cropping failed</td></tr><tr><td>-98</td><td>Text-detection analysis failed</td></tr><tr><td>-100</td><td>AI Artifact Removal processing failed</td></tr><tr><td>-101</td><td>vScene preset not found</td></tr><tr><td>-102</td><td>vScene number invalid</td></tr><tr><td>-103</td><td>vScene label buffer too small</td></tr></tbody></table>

</details>

<details>

<summary><strong>License errors (-50 to -99)</strong></summary>

<table><thead><tr><th width="170">Code</th><th>Description</th></tr></thead><tbody><tr><td>-50</td><td>Feature not licensed</td></tr><tr><td>-51</td><td>LAB feature not licensed</td></tr><tr><td>-52</td><td>Image limit feature not licensed</td></tr><tr><td>-53</td><td>Windows feature not licensed</td></tr><tr><td>-54</td><td>macOS feature not licensed</td></tr><tr><td>-55</td><td>Linux feature not licensed</td></tr><tr><td>-60</td><td>PDF feature not licensed</td></tr><tr><td>-61</td><td>TRON PDF feature not licensed</td></tr><tr><td>-62</td><td>V8 feature not licensed</td></tr><tr><td>-71</td><td>License build time error</td></tr><tr><td>-72</td><td>License error 1</td></tr><tr><td>-73</td><td>License error 2</td></tr><tr><td>-90 to -95</td><td>GUID license errors (wrong GUID used with the library)</td></tr><tr><td>-99</td><td>No license service available</td></tr></tbody></table>

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.viesus.com/support/error-codes/cli.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.