CLI Exit Codes

Complete reference of VIESUS CLI exit codes — meanings, categories, and what to do for each.

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. For symptom-based troubleshooting, see Troubleshooting → CLI.

---

Common license-related fixes

• Feature not licensed (codes -50 to -62) — confirm the AI features you're using are included in your license with [e-mail].
• GUID error (codes -90 to -95) — verify the GUID is correct and the DLL version matches the install.

General errors (-1 to -20)

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

Processing errors (-21 to -49)

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

Scene, crop & AI processing errors (-96 to -103)

Code	Description
-96	Scene-detection analysis failed
-97	Cropping failed
-98	Text-detection analysis failed
-100	AI Artifact Removal processing failed
-101	vScene preset not found
-102	vScene number invalid
-103	vScene label buffer too small

License errors (-50 to -99)

Code	Description
-50	Feature not licensed
-51	LAB feature not licensed
-52	Image limit feature not licensed
-53	Windows feature not licensed
-54	macOS feature not licensed
-55	Linux feature not licensed
-60	PDF feature not licensed
-61	TRON PDF feature not licensed
-62	V8 feature not licensed
-71	License build time error
-72	License error 1
-73	License error 2
-90 to -95	GUID license errors (wrong GUID used with the library)
-99	No license service available