Quickstart: Image Enhancement

Enhance your first image with the VIESUS CLI on Windows or Linux. From download to enhanced output in under 10 minutes.

Enhance your first image on-premise using the VIESUS CLI. This guide takes you from download to enhanced output.

Prerequisites: Access to the VIESUS Transfer Portal with a valid license

---

1

Install VIESUS

Download the package for your platform from transfer.viesus.com and install it. Choose the GPU installer if you have an NVIDIA Ampere GPU with ≥ 8 GB VRAM; otherwise use the CPU installer.

Linux (amd64)

sudo dpkg -i viesus-redist_<VERSION>_amd64.deb \
             viesus_<VERSION>_amd64.deb \
             viesus-license_<VERSION>_amd64.deb

# Verify installation
/usr/local/viesus/viesus -v

Windows

Right-click VIESUS_Viewer_and_CLI_Setup_VIESUS_<VERSION>_GPU_x64.exe → Run as administrator, accept the EULA, follow the wizard, restart when prompted.

# Verify installation
"C:\Program Files\Imaging Solutions\VIESUS\viesus.exe" -v

Expected output: VIESUS X.XX.XX ... (version matches the package you installed)

For the full walkthrough with screenshots see Installation.

2

Activate your license

After installing, activate your license on the target machine.

• GUID: No activation step needed. Keep your GUID handy — you'll pass it to every command in the enhancement steps below.
• Activation Key: Generate a request file with the VIESUS License Tool, send it to Viesus AG, and apply the activation file you receive back. Step-by-step with screenshots: Licensing → Activation Key.

No license yet? Contact [e-mail] to request a trial.

3

Enhance your first image

Process a single file.

Linux

/usr/local/viesus/viesus \
  -p viesusini.json \
  -s \
  -f /path/to/photo.jpg

Windows

"C:\Program Files\Imaging Solutions\VIESUS\viesus.exe" ^
  -p viesusini.json ^
  -s ^
  -f "C:\Photos\photo.jpg"

GUID users: add -g "your-guid" to every command, e.g. -g "4e8f35ab-7f72-4b1e-a1fd-2b5e9c58e9d3". Activation Key users omit the -g flag — the activated install unlocks the library at runtime.

The -s flag saves output in the same folder with a _viesus suffix:

• Input: photo.jpg → Output: photo_viesus.jpg

4

Process a batch

Create an image list file (images.lst) with one path per line, then run VIESUS.

Linux

# Generate list from a folder
find /path/to/photos -name "*.jpg" > images.lst

# Process
/usr/local/viesus/viesus \
  -p viesusini.json \
  -b /path/to/output \
  -l images.lst

Windows

# Generate list from a folder
dir /s /b /path/to/photos/*.jpg > images.lst

# Process
"C:\Program Files\Imaging Solutions\VIESUS\viesus.exe" ^
  -p viesusini.json ^
  -b "C:\Output" ^
  -l images.lst

A result file (images.res) is written alongside the list — one line per image with a status code.

---

Common issues at setup

Symptom	Cause	Fix
License not recognised	GUID wrong or spaced / activation file not applied	For GUID users, check the -g value; for Activation Key see Activation Key
File not found	Path in image list doesn't exist	Verify paths with ls or dir
Slow AI features	GPU not detected	Run nvidia-smi; ensure you installed the GPU variant
Permission denied	Output folder not writable	chmod 775 /path/to/output