pyvideotools : Quality Metrics & Video Encoding

WIP

Python utilities for video quality measurement and video encoding using VapourSynth.

Simple metric usage with statistics. x264 and SVT-AV1 bindings.

Features

• Quality metrics
  • SSIMULACRA2
  • XPSNR
  • Butteraugli
  • CVVDP
• CPU and GPU implementations
• x264 and SVT-AV1 encoding (WIP)

Requirements

• Python
• VapourSynth
• L-SMASH Works
• VS-ZIP and/or VSHIP
• FFmpeg, x264, SVT-AV1, or Turbo-Metrics depending on the features used

Examples

Quality metrics examples

from src.pyvideotools import metrics
from pathlib import Path

metric = metrics.VSzipSSIMULACRA2(
    source=Path("source.mkv"),
    distorted=Path("encoded.mkv"),
    skip=3,
)

metric.run()

print(metric.scores_standard_deviation)
print(metric.scores_median)

Encoding examples

SVT-AV1 CRF Encoding

from src.pyvideotools import encoders

cmd = encoders.SVTAV1CommandBuilder()
cmd.input("input.mkv")
cmd.preset("4")
cmd.crf(30)
cmd.output("output.mkv", overwrite=True)
cmd.run()

x264 2-pass target bitrate

from src.pyvideotools import encoders

cmd = encoders.x264CommandBuilder()
cmd.input("input.mkv")
cmd.preset("faster")
cmd.bitrate(682)
cmd.passes(2)
cmd.output("output.mkv", overwrite=True)
cmd.run()

Supported Implementations