36 releases

new 0.7.19 Nov 1, 2024
0.7.17 Jul 28, 2024
0.7.14 Feb 10, 2024
0.7.10 Dec 8, 2023
0.3.1 Mar 17, 2022

#3 in Video

Download history 33/week @ 2024-07-18 271/week @ 2024-07-25 92/week @ 2024-08-01 15/week @ 2024-08-08 17/week @ 2024-08-15 15/week @ 2024-08-22 7/week @ 2024-08-29 7/week @ 2024-09-05 12/week @ 2024-09-12 59/week @ 2024-09-19 48/week @ 2024-09-26 184/week @ 2024-10-03 24/week @ 2024-10-10 22/week @ 2024-10-17 16/week @ 2024-10-24 148/week @ 2024-10-31

217 downloads per month

MIT license

140KB
3.5K SLoC

ab-av1

AV1 video encoding tool with fast VMAF sampling & automatic encoder crf calculation. Uses ffmpeg, svt-av1 & vmaf.

Also supports other ffmpeg compatible encoders like libx265 & libx264.

Command: auto-encode

Automatically determine the best crf to deliver the min-vmaf and use it to encode a video or image.

Two phases:

  • crf-search to determine the best --crf value
  • ffmpeg to encode using the settings
ab-av1 auto-encode [OPTIONS] -i <INPUT> --preset <PRESET>

Interpolated binary search using sample-encode to find the best crf value delivering min-vmaf & max-encoded-percent.

Outputs:

  • Best crf value
  • Mean sample VMAF score
  • Predicted full encode size
  • Predicted full encode time
ab-av1 crf-search [OPTIONS] -i <INPUT> --preset <PRESET>

Command: sample-encode

Encode short video samples of an input using provided crf & preset. This is much quicker than full encode/vmaf run.

Outputs:

  • Mean sample VMAF score
  • Predicted full encode size
  • Predicted full encode time
ab-av1 sample-encode [OPTIONS] -i <INPUT> --crf <CRF> --preset <PRESET>

Command: encode

Invoke ffmpeg to encode a video or image.

ab-av1 encode [OPTIONS] -i <INPUT> --crf <CRF> --preset <PRESET>

Command: vmaf

Full VMAF score calculation, distorted file vs reference file. Works with videos and images.

  • Auto sets model version (4k or 1k) according to resolution.
  • Auto sets n_threads to system threads.
  • Auto upscales lower resolution videos to the model.
  • Converts distorted & reference to appropriate format yuv streams before passing to vmaf.
ab-av1 vmaf --reference <REFERENCE> --distorted <DISTORTED>

Install

Arch Linux

Available in the AUR.

Linux

Pre-built statically linked x86_64-unknown-linux-musl binary included in the latest release.

Windows

Pre-built ab-av1.exe included in the latest release.

Using cargo

Latest release

cargo install ab-av1

Latest code direct from git

cargo install --git https://github.com/alexheretic/ab-av1

Requirements

ffmpeg newer than git-2022-02-24 with libsvtav1, libvmaf, libopus enabled.

ffmpeg should be in $PATH.

Debug

Enable debug logs by setting env var RUST_LOG=ab_av1=debug. This includes all ffmpeg calls.

$ RUST_LOG=ab_av1=debug ab-av1 auto-encode -i vid.mkv

Minimum supported rust compiler

Maintained with latest stable rust.

Dependencies

~13–25MB
~386K SLoC