Netflix /vmaf

Perceptual video quality assessment based on multi-method fusion.

★ 5,601⑂ 852👁 477⑃ 1,093● 625▤ 26
CNOASSERTIONCreated 2016-02-08
More from this author
Download: v3.2.1v3.2.1 ↓3.2.12026-09-14
+1
Daily
5,601
stars
852
forks
477
watchers
1,093
prs
625
issues
26
releases

README

VMAF - Video Multi-Method Assessment Fusion






VMAF is an Emmy-winning perceptual video quality assessment algorithm developed by Netflix. This software package includes a stand-alone C library libvmaf and its wrapping Python library. The Python library also provides a set of tools that allows a user to train and test a custom VMAF model.

Read this tech blog post for an overview, this post for the tips of best practices, and this post for our latest efforts on speed optimization, new API design and the introduction of a codec evaluation-friendly NEG mode.

Also included in libvmaf are implementations of several other metrics: PSNR, PSNR-HVS, SSIM, MS-SSIM and CIEDE2000.

!vmaf logo

 News

- (2026-10-26) We are releasing an HDR version for VMAF-v1. Please refer to models_v1.md for more information.
- (2026-06) We are releasing a new set of VMAF models (v1). See tech blog for more information on v1. See models_v1.md for details and model selection guidance. The previous generation of models (v0) remains documented in models_v0.md. We are open to user feedback on VMAF v1 and will continue to improve and update the models over time.
- (2023-12-07) We are releasing libvmaf v3.0.0. It contains several optimizations and bug fixes, and a full removal of the APIs which were deprecated in v2.0.0.
- (2021-12-15) We have added to CAMBI the full_ref input parameter to allow running CAMBI as a full-reference metric, taking into account the banding that was already present on the source. Check out the usage page.
- (2021-12-1) We have added to CAMBI the max_log_contrast input parameter to allow to capture banding with higher contrasts than the default. We have also sped up CAMBI (e.g., around 4.5x for 4k). Check out the usage page.
- (2021-10-7) We are open-sourcing CAMBI (Contrast Aware Multiscale Banding Index) - Netflix's detector for banding (aka contouring) artifacts. Check out the tech blog for an overview and the technical paper published in PCS 2021 (note that the paper describes an initial version of CAMBI that no longer matches the code exactly, but it is still a good introduction). Also check out the usage page.
- (2020-12-7) Check out our latest tech blog on speed optimization, new API design and the introduction of a codec evaluation-friendly NEG mode.
- (2020-12-3) We are releasing libvmaf v2.0.0. It has a new fixed-point and x86 SIMD-optimized (AVX2, AVX-512) implementation that achieves 2x speed up compared to the previous floating-point version. It also has a new API that is more flexible and extensible.
- (2020-7-13) We have created a memo to share our thoughts on VMAF's property in the presence of image enhancement operations, its impact on codec evaluation, and our solutions. Accordingly, we have added a new mode called No Enhancement Gain (NEG).
- (2020-2-27) We have changed VMAF's license from Apache 2.0 to BSD+Patent, a more permissive license compared to Apache that also includes an express patent grant.

 Documentation

There is an

Top issues

Latest release

v3.2.1 v3.2.1 2026-09-14
Small release with a fix for 1587.

 What's Changed
 doc/vmaf_v1: update Netflix techblog url by @kylophone in https://github.com/Netflix/vmaf/pull/1545
 build(deps): bump actions/checkout from 6 to 7 by @dependabot[bot] in https://github.com/Netflix/vmaf/pull/1546
 build(deps): bump actions/cache from 4 to 6 by @dependabot[bot] in https://github.com/Netflix/vmaf/pull/1550
 libvmaf/thread_pool: fix thread pool queue depth to restore backpressure by @kylophone in https://github.com/Netflix/vmaf/pull/1557
 libvmaf/feature: enable speed_chroma/speed_temporal without enable_float by @kyloph

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON