Perfectly Clear Video CLI

The Video CLI provides command-line access to Perfectly Clear video correction capabilities for batch processing workflows. For Windows and Mac, this is accessed through the Perfectly Clear Video desktop application. For Linux, a custom ffmpeg filter is available for integration into video processing pipelines.

Overview

Process video files from the command line on Windows, macOS, and Linux. Ideal for:

• Batch video processing
• Automated workflows
• Server-side video enhancement
• Integration with video pipelines

Key Features

The Video CLI includes a comprehensive set of features designed to deliver quality video corrections with minimal configuration.

• AI-Powered Correction: Automatic exposure, color, and contrast adjustments
• White Balance: Intelligent color temperature correction
• Frame Smoothing: Reduces flicker between frames
• Split Processing: Preview corrections on part of the frame
• GPU Acceleration: Fast processing with hardware acceleration

Requirements

Before using the Video CLI, ensure your system meets the following requirements for your platform.

Windows / macOS

The desktop application provides all necessary components for video processing on Windows and macOS systems.

• Perfectly Clear Desktop Video application
• OpenGL 2.0+ capable GPU

Linux

Linux deployment requires a custom ffmpeg build with the Perfectly Clear filter integrated.

• Custom ffmpeg build with Perfectly Clear filter, matching your version of ffmpeg, CUDA and other runtime requirements
• NVIDIA GPU with CUDA support
• CUDA toolkit installed

Quick Start

Get started quickly with these basic commands for each platform. The following examples demonstrate the simplest way to process a video file.

Windows / macOS

The usage on all plaforms is similar, with the main difference being the executable name. Use the following commands in your terminal or command prompt:

Windows

Run the following command from the installation directory or add it to your system PATH:

"Perfectly Clear Video.exe" -i input.mp4 -o output.mp4

Mac

Execute the application from the terminal using the full path to the executable:

"Perfectly Clear Video" -i input.mp4 -o output.mp4

Linux

Navigate to the directory containing the PfCVideo script and run:

./PfCVideo.sh -i input.mp4 -o output.mp4

Basic Usage

The usage of the Perfectly Clear Video CLI is designed to be straightforward and consistent across platforms. The main difference is the executable name and path, but the command structure and options remain the same.
The examples below demonstrate how to run the CLI on Windows - the only difference on macOS is the executable path and name:

• Windows: C:\Program Files\Perfectly Clear Video\Perfectly Clear Video.exe
• Mac: /Applications/Perfectly Clear Video.app/Contents/MacOS/Perfectly Clear Video
• Linux: ./PfCVideo.sh (from the directory where the script is located)

Command Structure

All commands follow a consistent structure with the input and output files as required parameters, followed by optional settings.

"Perfectly Clear Video.exe" -i <input> -o <o> [options]

Required Parameters

Every command must include the input and output file parameters to specify which video to process and where to save the result.

Optional Parameters

These parameters allow you to fine-tune the correction behavior and output quality according to your specific needs.

Strenth and White Balance parameters

These control the correction intensity. Strength adjusts the overall correction, while White Balance specifically controls color correction. Both can be set from 0 (no correction) to 100 (full correction).

Divider parameter

This feature allows you to preview the correction on part of the frame. Setting a value between 0 and 100 will split the view, showing the original on one side and the corrected version on the other. A value of 0 disables this feature. A value of 50 would show a 50/50 split - the left half of the frame would show the original, and the right half would show the corrected version. This makes validating the corretion settings easier, as you can see the effect directly on the video.

Skip parameter

This controls how many frames are skipped between AI detections. A value of 0 means every frame is processed, while a value of 4 means every 5th frame is processed (4 frames are skipped, then the next frame is processed). Adjusting this can help balance processing time and correction quality. A higher value will also reduce visible "flicker" by averaging the correction over multiple frames.

Basic Examples

The following examples demonstrate common use cases for the Video CLI, from simple corrections to more advanced configurations.

Simple Correction

Apply default corrections to a video:

# Windows
"Perfectly Clear Video.exe" -i input.mp4 -o output.mp4

Adjusting Strength

Control overall correction intensity (0-100):

# Half strength
./Perfectly Clear Video.exe -i input.mp4 -o output.mp4 -s 50

White Balance Control

Adjust color correction strength (0-100):

# Combined with overall strength
./Perfectly Clear Video.exe -i input.mp4 -o output.mp4 -s 80 -w 60

Supported Formats

Windows and Mac support via Perfectly Clear Video application support the following formats:

• MP4 (H.264, H.265)
• MOV
• AVI

For linux, the supported formats depend on the ffmpeg build used, but generally include MP4, MOV, AVI, and more.