CLI & Viewer

Install the VIESUS CLI and Viewer on Windows or Linux, including the CPU and GPU installer variants.

This guide installs the VIESUS Viewer and CLI base package — the foundation every Windows interface builds on. AI features (AI upscaling, Artifact Removal, Background) ship as separate add-on installers; see AI Add-ons after completing this guide. License activation is covered under Licensing → Activation Key.

---

Choose your installer: CPU or GPU

The base package comes in two variants — pick the one that matches your hardware:

Installer	Use when	Notes
...GPU_x64.exe	The machine has a compatible NVIDIA GPU	Full hardware-accelerated AI processing. Requires NVIDIA Ampere or newer with ≥ 8 GB GPU RAM.
...CPU_x64.exe	No compatible NVIDIA GPU	All standard enhancement works; AI features (AI upscaling, Artifact Removal) run far slower and aren't recommended for production batches.

Replace <VERSION> in all filenames below with the version number shown on the Transfer Portal download page (for example, 13.00.00).

A CLI-only variant (VIESUS_CLI_Setup_VIESUS_<VERSION>_GPU_x64.exe) installs the command-line tool without the Viewer, for headless servers. The steps below apply to either; only the Viewer component differs.

---

1

Install VIESUS

Windows

Download the installer that matches your hardware from the VIESUS Transfer Portal, then right-click it and choose Run as administrator.

The Transfer Portal lists the base Viewer + CLI installers, add-ons, the PDF Enhancer, and patches.

1

Accept the license agreement

Read and accept the End-User License Agreement, then click Next.

2

Select components

The default Full installation includes the VIESUS License Tool, Commandline, FolderEnhancer, License Service, and Viewer. Leave all components checked unless you have a specific reason to exclude one, then click Next.

3

Additional tasks

Optionally check Create desktop icons, then click Next.

4

License Service settings (conditional)

This dialog appears only when the installer is launched from the command line with the /NET argument, for special network licensing setups:

VIESUS_Viewer_and_CLI_Setup_VIESUS_<VERSION>_GPU_x64.exe /NET

In a standard installation this step is skipped. When it appears, leave License Service Host Address blank and keep the defaults (port 9090, interface 127.0.0.1), then click Next.

Show Screenshot

5

Ready to install

Review the summary of selected components and tasks, then click Install.

Wait while the installer extracts and installs all files.

6

Finish and restart

Click Finish to exit the Setup Wizard, then restart Windows before continuing to license activation.

A restart is required before license activation. Skipping it can cause activation failures.

Linux

VIESUS ships for Linux as .deb (Debian/Ubuntu) and .rpm (Red Hat/CentOS/Fedora) packages, for both x64 and arm64. The distribution is split into three packages — all three must be installed:

Package	Contents
viesus-redist	Redistributable runtime libraries (OpenCV, shared dependencies)
viesus	VIESUS CLI, enhancement library, and AI models
viesus-license	License management tool (DongleStatus_64_RS)

On Linux the AI models are bundled in the viesus package — there are no separate add-on installers. The Windows add-ons described in AI Add-ons do not apply.

Download all three packages from the VIESUS Transfer Portal, then install:

# Debian / Ubuntu — remove previous versions if present
sudo dpkg -r viesus-license viesus viesus-redist

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

# Red Hat / CentOS / Fedora
sudo rpm -e viesus-license viesus viesus-redist   # remove old versions if present

sudo rpm -ivh viesus-redist_<VERSION>_x86_64.rpm \
              viesus_<VERSION>_x86_64.rpm \
              viesus-license_<VERSION>_x86_64.rpm

For arm64, use the _arm64.deb / aarch64.rpm package names. Full feature support requires an NVIDIA GPU; edge devices without a GPU run standard enhancement only.

2

Activate your license

Once VIESUS is installed and the machine has been restarted, activate your license on the target machine.

If you received a GUID (for deployments across multiple machines), no activation step on the install machine is required — the GUID is passed at runtime by each VIESUS interface. See Licensing → GUID.

With an 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.

3

Verify the installation

Open a command prompt and run:

viesus --version

You should see something like VIESUS X.XX.XX IF win 64 bit – Build … (version matches the package you installed). If the command isn't found, check that the VIESUS install directory is on your PATH.

For a complete first-run walkthrough including enhancing your first image, see Quickstart: Image Enhancement.

---

Troubleshooting

If activation fails, the license isn't recognised, or the CLI can't find the library:

• Confirm you restarted after install
• Verify the activation file matches the request file you generated
• Check that the viesus_64.dll you're calling matches the installed version (see FAQ → GUID doesn't work)
• For more, see Troubleshooting → First run and Troubleshooting → CLI