Quickstart: PDF Enhancement

Enhance your first PDF document with the VIESUS PDF Enhancer on Windows or Linux. From install to enhanced output in under 10 minutes.

Enhance your first PDF on-premise using the VIESUS PDF Enhancer. This guide takes you from installation to enhanced output.

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

---

1

Install the PDF Enhancer

Download from transfer.viesus.com and install. On Windows the VIESUS base package must be installed first; the Linux PDF Enhancer package bundles its own dependencies.

Linux (amd64)

sudo dpkg -i viesuspdf_<PDF_VERSION>_amd64.deb
sudo apt-get install -f

# Verify
/usr/local/viesuspdf/bin/viesuspdf -v

Windows

1

Install VIESUS_Viewer_and_CLI_Setup_VIESUS_<VERSION>_GPU_x64.exe (base package) first if not already installed.

2

Install VIESUS_PDFEnhancer_<PDF_VERSION>_VIESUS_<VERSION>.exe (right-click → Run as administrator, accept EULA, complete wizard).

"C:\Program Files\Imaging Solutions\VIESUS\PDFEnhancer\viesusPDF.exe" -v

Expected output: viesusPDF X.XX.XX 64 bit ... (version matches the package you installed)

For the full PDF Enhancer install walkthrough see Installation.

2

Activate your license

After installing, activate your license on the target machine.

• GUID: Add your GUID to the PDF Enhancer settings.json file. On Windows: C:\Program Files\Imaging Solutions\VIESUS\PDFEnhancer\settings.json. On Linux: /usr/local/viesuspdf/settings.json.

  {
    "guid": "4e8f35ab-7f72-4b1e-a1fd-2b5e9c58e9d3"
  }

• 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

Create an enhancement configuration

Create viesusini.json with a minimal enhancement configuration:

{
  "Config": {
    "Enhancemode": 1,
    "NoiseRedMode": 1,
    "SHPmode": 1,
    "FDmode": 1,
    "RERmode": 1,
    "FRmode": 1,
    "ARmode": 2
  },
  "Other": {
    "JpegComprQuality": 95
  }
}

This enables color correction, noise reduction, sharpening, face detection, red-eye removal, face reconstruction, and AI artifact removal for each embedded image in the PDF.

4

Enhance your first PDF

Run in stand-alone mode, passing the source PDF, output folder, and your configuration file.

Linux

/usr/local/viesuspdf/bin/viesuspdf \
  /path/to/document.pdf \
  /path/to/output \
  /path/to/viesusini.json

Windows

"C:\Program Files\Imaging Solutions\VIESUS\PDFEnhancer\viesusPDF.exe" ^
  "C:\PDFs\document.pdf" ^
  "C:\Output" ^
  "C:\Config\viesusini.json"

The PDF Enhancer writes two files to the output folder:

File	Description
document_dest.pdf	Enhanced PDF with improved embedded images
document.pdf.xml	Processing report — image counts, statistics, error codes

The XML file is written last; you can use it as a completion signal in automated pipelines.

---

Common issues at setup

Symptom	Cause	Fix
License not recognised / no enhancement	GUID missing/incorrect in settings.json, or activation file not applied	For GUID, check the guid field in settings.json; for Activation Key, see Activation Key
Output PDF identical to input	No qualifying images found	Check the XML report for image counts and skip reasons
viesusPDF not found	Installation incomplete or PATH not set	Verify installation directory and restart the terminal
Permission denied on output folder	Output folder not writable	chmod 775 /path/to/output (Linux) or check folder permissions (Windows)