Av1an
A cross-platform framework to streamline encoding
Easy, Fast, Efficient and Feature Rich
An easy way to start using AV1 / HEVC / H264 / VP9 / VP8 encoding. AOM, RAV1E, SVT-AV1, SVT-VP9, VPX, x265, x264 are supported.
Example with default parameters:
av1an -i input
With your own parameters:
av1an -i input -v " --cpu-used=3 --end-usage=q --cq-level=30 --threads=8 " -w 10
--target-quality 95 -a "-c:a libopus -ac 2 -b:a 192k" -log my_log -o output
Usage
-i --input Input file(s), or Vapoursynth (.py,.vpy) script
(relative or absolute path)
-o --output-file Name/Path for output file (Default: (input file name)_(encoder).mkv)
Output is `mkv` by default
Ouput extension can be set to: `mkv`, `webm`, `mp4`
-e --encoder Encoder to use
[default: aom] [possible values: aom, rav1e, vpx, svt-av1, x264, x265]
-v --video-params Encoder settings flags (If not set, will be used default parameters.)
Must be inside ' ' or " "
-p --passes Set number of passes for encoding
(Default: AOMENC: 2, rav1e: 1, SVT-AV1: 1, SVT-VP9: 1,
VPX: 2, x265: 1, x264: 1)
-w --workers Override number of workers.
-r --resume Resumes encoding.
--keep Doesn't delete temporary folders after encode has finished.
-q --quiet Do not print a progress bar to the terminal.
-l --logging Path to .log file(By default created in temp folder)
--temp Set path for the temporary folder. [default: .hash]
-c --concat Concatenation method to use for splits Default: ffmpeg
[possible values: ffmpeg, mkvmerge, ivf]
FFmpeg options
-a --audio-params FFmpeg audio settings (Default: copy audio from source to output)
Example: -a '-c:a libopus -b:a 64k'
-f --ffmpeg FFmpeg options video options.
Applied to each encoding segment individually.
(Warning: Cropping doesn't work with Target VMAF mode
without specifying it in --vmaf-filter)
Example:
--ff " -vf scale=320:240 "
--pix-format Setting custom pixel/bit format for piping
(Default: 'yuv420p10le')
Segmenting
--split-method Method used for generating splits.(Default: av-scenedetect)
Options: `av-scenedetect`, `none`
`none` - skips scenedetection.
-m --chunk-method Determine the method in which chunks are made for encoding.
By default the best method is selected automatically.
[possible values: segment, select, ffms2, lsmash, hybrid]
-s --scenes File to save/read scenes.
-x --extra-split Size of chunk after which it will be split [default: 240]
--min-scene-len Specifies the minimum number of frames in each split.
Target Quality
--target-quality Quality value to target.
VMAF used as substructure for algorithms.
When using this mode, you must use quantizer/quality modes of enocoder.
--target-quality-method Type of algorithm for use.
Options: per_shot
--min-q, --max-q Min,Max Q values limits
If not set by the user, the default for encoder range will be used.
--vmaf Calculate VMAF after encoding is done and make a plot.
--vmaf-path Custom path to libvmaf models.
example: --vmaf-path "vmaf_v0.6.1.pkl"
Recommended to place both files in encoding folder
(`vmaf_v0.6.1.pkl` and `vmaf_v0.6.1.pkl.model`)
(Required if VMAF calculation doesn't work by default)
--vmaf-res Resolution for VMAF calculation.
[default: 1920x1080]
--probes Number of probes for target quality. [default: 4]
--probe-slow Use probided video encoding parameters for vmaf probes.
--vmaf-filter Filter used for VMAF calculation. The passed format is filter_complex.
So if crop filter used ` -ff " -vf crop=200:1000:0:0 "`
`--vmaf-filter` must be : ` --vmaf-filter "crop=200:1000:0:0"`
--probing-rate Setting rate for VMAF probes. Using every N frame used in probe.
[default: 4]
--vmaf-threads Limit number of threads that are used for VMAF calculation
Main Features
Splitting video by scenes for parallel encoding because AV1 encoders are currently not very good at multithreading and encoding is limited to a very limited number of threads.
- Vapoursynth script input support.
- Speed up video encoding.
- Target Quality mode. Targeting end result reference visual quality. VMAF used as a substructure
- Resuming encoding without loss of encoded progress.
- Simple and clean console look.
- Automatic detection of the number of workers the host can handle.
- Both video and audio transcoding.
Install
-
With a package manager:
-
Prerequisites:
- Install FFmpeg
- Recommended to install vapoursynth with lsmash/ffms2 for faster and better processing
-
Encoder of choice:
- Install AOMENC
- Install rav1e
- Install SVT-AV1
- Install SVT-VP9
- Install vpx VP9, VP8 encoding
-
Optional :
-
Manually:
- Clone Repo or Download from Releases
cargo build --release
Docker
Av1an can be run in a Docker container with the following command if you are in the current directory Linux
docker run --privileged -v "$(pwd):/videos" --user $(id -u):$(id -g) -it --rm masterofzen/av1an:latest -i S01E01.mkv {options}
Windows
docker run --privileged -v "${PWD}:/videos" -it --rm masterofzen/av1an:latest -i S01E01.mkv {options}
Docker can also be built by using
docker build -t "av1an" .
To specify a different directory to use you would replace $(pwd) with the directory
docker run --privileged -v "/c/Users/masterofzen/Videos":/videos --user $(id -u):$(id -g) -it --rm masterofzen/av1an:latest -i S01E01.mkv {options}
The --user flag is required on linux to avoid permission issues with the docker container not being able to write to the location, if you get permission issues ensure your user has access to the folder that you are using to encode.
Docker tags
The docker image has the following tags
| Tag | Description |
|---|---|
| latest | Contains the latest stable av1an version release |
| master | Contains the latest av1an commit to the master branch |
| sha-##### | Contains the commit of the hash that is referenced |
| #.## | Stable av1an version release |
Support the developer
Bitcoin - 1GTRkvV4KdSaRyFDYTpZckPKQCoWbWkJV1
![[Question] How to resize video while keeping target-quality when using SVT-AV1 codec](https://avatars.githubusercontent.com/u/101082169?v=4)
aom_keyframes use the first pass of aomenc for determining where keyframes will be placed by the encoder, and using this information for splitting, resulting in 0 loss of encoding efficiency by segmenting for this encoder.
Finished personal encodes:
Started work on making automated tests for Av1an
6 Oct 17, 2021
7 Aug 22, 2022
155 Nov 28, 2022
2 Nov 14, 2022
5 May 26, 2022
9 Nov 13, 2022
16 Nov 30, 2022
380 Jan 08, 2023
739 Dec 30, 2022
7 Apr 26, 2022
45 Nov 12, 2022
1.9k Jan 07, 2023
10 Mar 12, 2022
1 Feb 28, 2022
2 Oct 16, 2021
4 Dec 07, 2021
542 Dec 03, 2022
3 May 04, 2022
7 Jul 10, 2022
144 Dec 19, 2022