Skip to content

Installation & Setup

Visual Enhancer is distributed as a portable 64-bit Windows folder containing the desktop application (Visual Enhancer.exe), the command-line tool (VE_CLI.exe), bundled codecs (ffmpeg.exe, ffprobe.exe), and native runtime libraries.

  1. Extract the portable archive

    Unpack the release archive to a local NTFS drive with plenty of free space (for example, D:\Apps\Visual Enhancer). Avoid extracting inside read-only folders such as Program Files so the app can write to its portable outputs and logs directories.

  2. Launch Visual Enhancer.exe

    Start the desktop app or inspect your GPUs from a terminal with VE_CLI.exe devices.

  3. Download optional AI models (when needed)

    Built-in NVIDIA RTX / DLSS features, ReShade shader effects, LUT grading, scaling, and format conversion work immediately. If your workflow uses ClearMagnetar, FocusPulsar, VisionNext, RazorNext, PeakMagnetar, OptiPulsar, or MoGe-2 AI depth, open Models in the header bar to install them and NeuroFrame Runtime.

  4. Load a file and run your first render

    Drag and drop an image or video (or press Ctrl+V to paste from the clipboard), enable cards in the Pipeline rail, adjust parameters in the right inspector, and click Render.

Visual Enhancer separates portable deliverables (your exported files and session logs) from large shared model weights and temporary preview caches:

Purpose Default Location Environment Override Notes
Portable exports <app-folder>\outputs\ VE_APP_ROOT Default destination when Export Path is set to Output
Session logs <app-folder>\logs\ VE_APP_ROOT Created automatically at startup; opened via Settings > Open Logs
AI models & NeuroFrame Runtime %LOCALAPPDATA%\Merserk\Visual Enhancer\Models VE_MODELS_DIRECTORY Stores downloaded .safetensors, moge-2-vitb, NeuroFrame Runtime, and models-manifest.json
App preferences %LOCALAPPDATA%\Merserk\Visual Enhancer\config.ini — Persists active settings, language, and UI state
Processing & preview caches %LOCALAPPDATA%\Merserk\Visual Enhancer\cache\ — Holds temporary preview renders; safely reclaimable in Settings > Processing Cache
NVIDIA runtime data %LOCALAPPDATA%\Merserk\Visual Enhancer\NVIDIA\ — Writable scratch area required by NVIDIA NGX

Visual Enhancer detects images and videos by file extension and decodes high-precision color channels (up to 16-bit RGBA / planar YUV) automatically.

png, jpg, jpeg, webp, avif, jxl, tif, tiff, bmp, heic, heif, svg, gif

  • TIFF / PNG / JPEG XL / AVIF: High-bit-depth inputs preserve 16-bit precision into the processing pipeline.
  • HEIF / HEIC: Decoded via bundled libheif with embedded ICC color profiles converted cleanly to sRGB.
  • Clipboard & URLs: You can paste local file paths, copied images, HTML <img> fragments, or direct http:// / https:// image URLs (up to 30 MiB per fetch).

Decoded at 16-bit with camera white balance and sRGB output color space:

3fr, arw, bay, cap, cr2, cr3, dcr, dcs, dng, drf, eip, erf, fff, gpr, iiq, k25, kdc, mdc, mef, mos, mrw, nef, nrw, obm, orf, pef, ptx, pxn, r3d, raf, raw, rw2, rwl, rwz, sr2, srf, srw, x3f

mp4, mkv, mov, avi, webm, m4v, ts, mts, m2ts, wmv, flv