2022-07-13 08:14:58 +00:00
# Av1an
2020-01-11 14:05:38 +00:00
2022-07-13 08:14:58 +00:00
2020-01-11 14:05:38 +00:00
2022-07-13 08:14:58 +00:00
[](https://discord.gg/Ar8MvJh)
[](https://github.com/master-of-zen/Av1an/actions/workflows/tests.yml)
[](https://crates.io/crates/av1an)
2022-07-13 09:32:59 +00:00
[](https://github.com/master-of-zen/Av1an)
2020-01-12 03:44:02 +00:00
2022-07-13 09:32:59 +00:00
Av1an is a video encoding framework. It can increase your encoding speed and improve cpu utilization by running multiple encoder processes in parallel. Target quality, VMAF plotting, and more, available to take advantage for video encoding.
2020-01-13 14:07:26 +00:00
2024-01-05 14:26:27 +00:00
For help with av1an, please reach out to us on [Discord ](https://discord.gg/Ar8MvJh ) or file a GitHub issue.
2022-07-13 08:14:58 +00:00
## Features
2020-05-08 04:44:45 +00:00
2022-07-13 09:32:59 +00:00
- Hyper-scalable video encoding
- [Target Quality ](/docs/TargetQuality.md ) mode, using VMAF control encoders rate control to achieve the desired video quality
2022-07-13 08:14:58 +00:00
- [VapourSynth ](http://www.vapoursynth.com ) script support
2022-07-13 09:32:59 +00:00
- Cancel and resume encoding without loss of progress
- Minimal and clean CLI
- Docker images available
2022-07-13 08:14:58 +00:00
- Cross-platform application written in Rust
2020-01-12 03:44:02 +00:00
2022-07-13 09:32:59 +00:00
## Usage
For complete reference, refer to [CLI ](/docs/CLI.md )
or run `av1an --help`
Encode a video file with the default parameters:
```sh
av1an -i input.mkv
```
Or use a VapourSynth script and custom parameters:
```sh
av1an -i input.vpy -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" -l my_log -o output.mkv
```
2022-07-13 08:14:58 +00:00
## Supported encoders
2020-01-12 03:44:02 +00:00
2022-07-13 08:14:58 +00:00
At least one encoder is required to use Av1an. The following encoders are supported:
2020-01-12 03:44:02 +00:00
2022-07-13 08:14:58 +00:00
- [aomenc ](https://aomedia.googlesource.com/aom/ ) (AV1)
- [SvtAv1EncApp ](https://gitlab.com/AOMediaCodec/SVT-AV1 ) (AV1)
- [rav1e ](https://github.com/xiph/rav1e ) (AV1)
- [vpxenc ](https://chromium.googlesource.com/webm/libvpx/ ) (VP8 and VP9)
- [x264 ](https://www.videolan.org/developers/x264.html ) (H.264/AVC)
- [x265 ](https://www.videolan.org/developers/x265.html ) (H.265/HEVC)
2021-05-15 05:50:18 +00:00
2022-07-13 08:14:58 +00:00
Note that Av1an requires the executable encoder. If you use a package manager to install encoders, check that the installation includes an executable encoder (e.g. vpxenc, SvtAv1EncApp) from the list above. Just installing the library (e.g. libvpx, libSvtAv1Enc) is not enough.
2020-05-08 04:34:25 +00:00
2022-04-16 21:00:33 +00:00
## Installation
2021-10-10 17:25:27 +00:00
2022-07-13 09:32:59 +00:00
av1an can be installed from package managers, cargo.io, or compliled manually. There are also pre-built [Docker images ](/docs/DOCKER.md ) which include all dependencies and are frequently updated.
2022-04-17 04:01:50 +00:00
2022-07-13 09:32:59 +00:00
For Windows users, prebuilt binaries are also included in every [release ](https://github.com/master-of-zen/Av1an/releases ), and a [nightly build ](https://github.com/master-of-zen/Av1an/releases/tag/latest ) of the current `master` branch is also available.
2022-04-17 04:01:50 +00:00
2022-07-13 08:14:58 +00:00
### Package managers
2022-04-17 04:01:50 +00:00
2022-07-13 08:14:58 +00:00
Arch Linux & Manjaro: `pacman -S av1an`
2022-07-13 09:32:59 +00:00
Cargo: `cargo install av1an`
2022-04-17 04:01:50 +00:00
2022-07-13 08:14:58 +00:00
### Manual installation
2022-04-17 04:01:50 +00:00
2022-07-13 08:14:58 +00:00
Prerequisites:
2022-04-17 04:01:50 +00:00
2022-07-13 08:14:58 +00:00
- [FFmpeg ](https://ffmpeg.org/download.html )
- [VapourSynth ](https://github.com/vapoursynth/vapoursynth/releases )
- At least one [encoder ](#supported-encoders )
2022-04-17 04:01:50 +00:00
2022-07-13 08:14:58 +00:00
Optional:
2022-04-17 04:01:50 +00:00
2022-07-13 08:14:58 +00:00
- [L-SMASH ](https://github.com/AkarinVS/L-SMASH-Works ) VapourSynth plugin for better chunking (recommended)
- [ffms2 ](https://github.com/FFMS/ffms2 ) VapourSynth plugin for better chunking
2023-11-26 08:20:27 +00:00
- [bestsource ](https://github.com/vapoursynth/bestsource ) Vapoursynth plugin for slow but accurate chunking
2022-07-13 08:14:58 +00:00
- [mkvmerge ](https://mkvtoolnix.download/ ) to use mkvmerge instead of FFmpeg for file concatenation
- [VMAF ](https://github.com/Netflix/vmaf ) to calculate VMAF scores and to use [target quality mode ](docs/TargetQuality.md )
2022-04-17 04:01:50 +00:00
2022-07-13 08:14:58 +00:00
### VapourSynth plugins on Windows
2022-04-17 04:01:50 +00:00
2022-07-13 08:14:58 +00:00
If you want to install the L-SMASH or ffms2 plugins and are on Windows, then you have [two installation options ](http://vapoursynth.com/doc/installation.html#plugins-and-scripts ). The easiest way is using the included plugin script:
2022-04-17 04:01:50 +00:00
2022-07-13 08:14:58 +00:00
1. Open your VapourSynth installation directory
2. Open a command prompt or PowerShell window via Shift + Right click
3. Run `python3 vsrepo.py install lsmas ffms2`
2022-04-17 04:01:50 +00:00
2022-07-13 08:14:58 +00:00
## Support the developer
2020-05-08 04:34:25 +00:00
2021-02-26 13:55:06 +00:00
Bitcoin - 1GTRkvV4KdSaRyFDYTpZckPKQCoWbWkJV1
