# FFMetrics

Canonical URL: https://encode.wiki/tools/utilities/ffmetrics/
Content version: ca42e61ede0a24f789d7287a0001244ad22f4abf
Status: current
License: CC BY-SA 4.0
Checksum (SHA-256): 529d2f8b6df07bc6aeb60920d9ab547c781a50da296e7ba8765a6b7798748aa3

> **Repository:** [fifonik/FFMetrics](https://github.com/fifonik/FFMetrics). Visualizes Video Quality Metrics (PSNR, SSIM, XPSNR & VMAF) calculated by ffmpeg.exe. Latest release: [v1.7.0](https://github.com/fifonik/FFMetrics/releases/tag/v1.7.0), May 6, 2026. Last commit: May 13, 2026. Stars: 1,034.

FFMetrics is a free Windows program by fifonik that runs FFmpeg's quality metrics, [PSNR](/reference/metrics/psnr/), [SSIM](/reference/metrics/ssim/), [VMAF](/reference/metrics/vmaf/) and [XPSNR](/reference/metrics/xpsnr/), for one reference and up to 24 encodes in one go, and draws interactive per-frame graphs. It saves you writing FFmpeg commands and makes it easy to see where in a clip each encode drops.

It only offers FFmpeg's metrics. PSNR, SSIM and VMAF are weak judges for comparing encoders or psychovisual settings, and XPSNR is the most useful of the four. For SSIMULACRA2, Butteraugli and CVVDP, use [Vship](/tools/utilities/vship/), whose FFVship tool can also draw per-frame graphs. Either way, look at the frames the graph points to; see [Compare encoding quality](/guides/compare-encoding-quality/).

> **Caution — XPSNR in 1.7.0.**
>
> FFmpeg's `xpsnr` filter takes the reference first, the opposite of the other metric filters. FFMetrics 1.7.0 passes the files the other way round, so its XPSNR results are wrong; 1.8.0 beta 1 fixed this. Use the 1.8.0 beta for XPSNR.
## Install

1. Download the latest release from [GitHub](https://github.com/fifonik/FFMetrics/releases) (stable 1.7.0, or 1.8.0 beta 2) and unpack it.
2. Put `ffmpeg.exe` (and its DLLs, for a shared build) in the program folder or on your `PATH`.
3. For VMAF, the FFmpeg build needs libvmaf. FFMetrics uses the models built into recent libvmaf, or JSON/PKL model files in its `vmaf-models` subfolder; the archive includes the common ones.

It needs .NET Framework 4.8, which Windows 10 1903 and later already include. The repository has no licence file; the author describes the program as free, with no registration or tracking.

## Use it

Drag the reference file onto the Reference field and the encodes onto the file list, tick the metrics you want, and click **Start**. The graphs update while FFmpeg runs and can be zoomed, panned and saved as PNG or SVG. You can also:

- analyse only part of the files;
- save "bad" frames as PNG images to look at;
- export per-frame values and summary results as tab-separated CSV files;
- log the FFmpeg commands it runs, which helps when a result looks wrong.

FFMetrics picks a VMAF model from the reference's resolution and, by default, scales both inputs to the model's resolution when they differ from it by more than 10%; with that turned off it scales the encode to the reference's size. Both can be changed in the VMAF options.

**Keep colour range and tags consistent.** If the files differ in colour range, or carry wrong range metadata, FFmpeg's automatic conversion can give incorrect results. The 1.8.0 betas add a pixel format control for the conversion applied before measuring.

## Command line

```text
FFMetrics.exe [options] reference.mp4 encode1.mp4 [encode2.mp4 ...]
```

| Option                         | Effect                                                         |
| ------------------------------ | -------------------------------------------------------------- |
| `-metric=PSNR\|SSIM\|VMAF\|XPSNR` | Metric to calculate; repeat for several                     |
| `-run`, `-exit`                | Start immediately; quit when finished                          |
| `-skip=<s>`, `-duration=<s>`   | Analyse only part of the video                                 |
| `-log-frames`                  | Save per-frame values as CSV                                   |
| `-log-commands`                | Log the FFmpeg commands used                                   |
| `-vmaf-model=<name>`           | VMAF model, e.g. `vmaf_v0.6.1neg`                              |
| `-vmaf-scale-to-model=0`       | Don't scale to the model's resolution                          |
| `-scaling-method=<method>`     | Scaler for resizing (default `BICUBIC`)                        |

For example, to score two encodes with XPSNR (1.8.0 beta) and NEG VMAF and save per-frame CSVs:

```text
FFMetrics.exe -log-frames -metric=XPSNR -metric=VMAF -vmaf-model=vmaf_v0.6.1neg -run reference.mp4 encode1.mp4 encode2.mp4
```