Image Enhancement CLI

The VIESUS image enhancement tool processes individual image files or collections of images with various enhancement algorithms.

Basic Syntax

viesus [options] [-l imagelist | -f file1 [file2 ...]]

Input Methods

Method	Parameter	Description
File List	`-l <imagelist>`	Process images listed in a text file (one path per line)
Direct Files	`-f <file1> [file2 ...]`	Process specified image files directly

Important: The -f option must be the last parameter on the command line.

Core Options

Parameter	Argument	Description
`-b <path>`	String	Base path for saving enhanced image results
`-p <file>`	String	Path to parameter/configuration INI file
`-i`	None	Save enhanced images with same filename (overwrites original)
`-s`	None	Save enhanced images in same folder with default suffix `_viesus`
`-n <suffix>`	String	Save enhanced images with custom suffix. Only valid when `-b` is not used.
`-e`	None	Enhance only images containing valid EXIF data
`-a`	None	Force re-enhancement of already processed images (not recommended)

Information Options

Parameter	Description
`-I`	Display license information, for GUID libraries the GUID must be specified using `-g GUID`
`-v`	Display VIESUS library version
`-h`	Show help information

Output

When processing images with the CLI, the result of the processing is written into a text file with a line for every image processed and an error code. When images are specified using the -f option, the file is named Images.res. When image lists are processed (e.g., ImageList.lst), the name of the text file is ImageList.res. Besides detailed results, the file also contains processing statistics.

CLI Usage Examples

Create Image List and Process

# Windows: Create image list
dir /b /s *.JPG > Images.lst

# Process using image list
viesus -l Images.lst -s -p "TempFolder\Viesus_Configuration.json" -n "_myConfig" -b "TempFolder"

Process Individual Files

# Process specific files with custom suffix
viesus -s -n "_enhanced" -p "config.json" -f image1.jpg image2.jpg image3.jpg

# Process files and save to different directory
viesus -b "C:\output" -s -p "settings.json" -f "C:\input\photo.jpg"

Image List Format

Image list files contain in the simplest form one image path per line:

C:\Photos\image1.jpg
C:\Photos\image2.png
D:\Pictures\vacation\sunset.jpg

Adding a second path for the destination image separated by a colon is also possible.

Creating Image Lists

Windows:

# All JPG files recursively
dir /b /s *.JPG > Images.lst

# Multiple extensions
dir /b /s *.jpg *.png *.tiff > Images.lst

# Specific folder
dir /b "C:\Photos\*.jpg" > Images.lst

Linux:

# All JPG files recursively
find /path/to/images -name "*.jpg" > images.lst

# Multiple extensions
find /path/to/images \( -name "*.jpg" -o -name "*.png" \) > images.lst

Output Naming Conventions

Option	Example Input	Example Output	Location
`-s`	`photo.jpg`	`photo_viesus.jpg`	Same folder as input
`-n "_custom"`	`photo.jpg`	`photo_custom.jpg`	Same folder as input
`-b "output" -s`	`photo.jpg`	`photo_viesus.jpg`	`output/` folder
`-i`	`photo.jpg`	`photo.jpg`	Same location (overwrites)

Best Practices

Use image lists for batch processing large numbers of files
Test parameters on a small subset before processing entire collections
Backup originals before using -i option (overwrites files)
Monitor disk space when using -b option with large image sets
EXIF filtering (-e) can improve processing speed by skipping non-photographic images

Common Processing Workflows

Basic Image Enhancement

# 1. Create image list
dir /b /s *.jpg > photos.lst

# 2. Enhance with default settings
viesus -l photos.lst -s -p "standard_config.json"

Professional Photo Processing

# 1. Filter for photos with EXIF data only
# 2. Use custom configuration and naming
viesus -l photos.lst -e -s -n "_pro" -p "professional.json" -b "enhanced" -T 8

Performance Considerations

Batch size: Process images in reasonable batch sizes to avoid memory issues
Network paths: Avoid processing over slow network connections when possible
Thread optimization: Use -T with CPU core count for best performance
Memory management: Process large image collections in smaller batches
EXIF filtering: Use -e to skip non-photographic images and improve speed
Output location: Use -b to write to fast storage (SSD preferred)

Basic Syntax​

Input Methods​

Core Options​

Information Options​

Output​

CLI Usage Examples​

Create Image List and Process​

Process Individual Files​

Image List Format​

Creating Image Lists​

Output Naming Conventions​

Best Practices​

Common Processing Workflows​

Basic Image Enhancement​

Professional Photo Processing​

Performance Considerations​