Skip to content

About

Calculate VMAF, VMAF NEG, VMAF v1, SSIMULACRA2, Butteraugli and ColorVideo VDP on NVIDIA, AMD and Intel GPUs, alongside PSNR, SSIM and XPSNR. Compare encodes with frame-exact playback that switches between the source and each encode instantly to easily spot differences.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

32 stars

Watchers

0 watching

Forks

Repository files navigation

VideoMetricsLab

Calculate VMAF, VMAF NEG, VMAF v1, SSIMULACRA2, Butteraugli and ColorVideo VDP on NVIDIA, AMD and Intel GPUs, alongside PSNR, SSIM and XPSNR. Compare encodes with frame-exact playback that switches between the source and each encode instantly to easily spot differences.

New in v2.0: VMAF, VMAF NEG and VMAF v1 on any GPU (NVIDIA, AMD or Intel), PSNR, SSIM and XPSNR up to 11x faster with far less memory, a command line, and 120 fps 4K HDR playback in Video Compare. See the changelog.

Features

Metrics

  • VMAF v0.6.1, VMAF NEG, VMAF v1, PSNR, SSIM, XPSNR, SSIMULACRA2, Butteraugli and ColorVideo VDP, for many test videos at once.
  • VMAF models for standard, phone, 4K and HFR viewing.

Fast on any GPU

  • VMAF, VMAF NEG and VMAF v1 on NVIDIA, AMD and Intel GPUs with libvmaf-fast: VMAF v1 up to 17x faster.
  • SSIMULACRA2, Butteraugli and ColorVideo VDP on the GPU with Vship (CUDA, HIP or Vulkan); libjxl on the CPU when no GPU can be used, for SSIMULACRA2 and Butteraugli.
  • PSNR, SSIM and XPSNR 2.7x-11x faster, calculated in the app.
  • GPU video decoding, with software decoding for formats the GPU can't handle, such as VVC.

Compare and inspect

  • Frame-exact playback that switches instantly between the source and each encode (hold S), with zoom, at up to 120 fps in 4K HDR.
  • Metric curves, statistics and per-frame scores (per second for ColorVideo VDP), with each metric's best and worst results highlighted.
  • Bitrate by frame, second or GOP.

Workflow

  • Black bars and resolution mismatches handled automatically.
  • Results saved and reloaded automatically.
  • Drag and drop videos, sort and reorder the list, and a dark theme.
  • A command line, VideoMetricsLab-cli, for scripts.
  • Two test videos calculated in parallel on many-core CPUs.

Videos

Configure each test independently, inspect its codec and bitrate, and calculate multiple quality metrics in one run.

Videos tab with H.264 and HEVC test encodes

Metric graphs

Compare real per-frame curves and distribution statistics. The frame readout shows both test values and their signed delta at the same moment.

VMAF graph, statistics, and per-frame delta for two test encodes

Video Compare

Switch instantly between the reference and test encodes during playback, or seek to an exact frame for close inspection.

Frame-exact Video Compare view with keyboard controls

Bitrate Viewer

Analyze video-only bitrate independently by frame, second, or GOP.

Bitrate Viewer results for two test encodes

Quick start

  1. Select a reference video.
  2. Add one or more test videos.
  3. Choose the metrics to calculate.
  4. Click Calculate metrics.

Results appear in the video table and Metric Graphs tab as each test finishes. Video Compare and Bitrate Viewer can also be used without calculating metrics.

For detailed instructions, see the User Guide.

Install

Packaged release

Download the Windows zip from the latest release, extract it, and run VideoMetricsLab.exe.

The app requires FFmpeg 9 or newer with libvmaf. FFmpeg is not bundled; the app prompts for its location if it is not available on PATH.

Run from source

Requires Python 3.11 or newer:

py -3 -m venv .venv
.venv\Scripts\python.exe -m pip install -r requirements.txt
.venv\Scripts\python.exe -m vmaf_app.main

Requirements

  • Windows 10 or 11
  • FFmpeg 9+ with ffmpeg, ffprobe, and libvmaf
  • Optional NVIDIA, Intel, or AMD GPU for hardware decoding and the GPU metrics
  • Python 3.11+ when running from source

Development

.venv\Scripts\python.exe -m pip install -r requirements-dev.txt
.venv\Scripts\python.exe -m pytest
.venv\Scripts\python.exe -m ruff check vmaf_app tests scripts

Build the distributable with ./scripts/build_release.ps1. See the build guide and contributing guide for more.

Documentation

User Guide · Troubleshooting · Known Issues · Architecture · Changelog · Security

License

Licensed under the MIT License. Copyright (c) 2026 4KVCD. Third-party components retain their own licenses; see Third-Party Notices.

❤️ Enjoying VideoMetricsLab?

If VideoMetricsLab has been useful to you, I'd love to hear from you!

💬 Leave a comment / say thanks

You can also ⭐ star the repository — it helps me know people are finding the project useful.

Changelog

See the changelog for what changed in each version.

About

Calculate VMAF, VMAF NEG, VMAF v1, SSIMULACRA2, Butteraugli and ColorVideo VDP on NVIDIA, AMD and Intel GPUs, alongside PSNR, SSIM and XPSNR. Compare encodes with frame-exact playback that switches between the source and each encode instantly to easily spot differences.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

32 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages