rAV1ator CLI

An easy-to-use CLI utility for working with Av1an, written in Bash.

~ > rav1ator-cli -h
rAV1ator: CLI Edition_ v0.2.2

Usage:
	rav1ator-cli [input] [output] [--offline]

Dependencies (Arch): 
	zstd tar ffmpeg python mkvtoolnix-cli vapoursynth gum numactl l-smash vapoursynth-plugin-lsmashsource av1an ffms2

Options: (Currently, only one option is useful at a time)
	-h, --help			Print this help section
	-l, --last-used		Print last used encode settings from history
	-f, --full-history	Print full history from ".rav1ator-cli-history" file
	-b, --binaries		Just install binaries, then exit
	-x, --offline		Don't check for updates.
	-a, --batch			Batch encode. All video files in a directory specified after this flag are encoded.

rAV1ator CLI can:

• Check if it is installed & up to date on its own without a package manager

• Download AVX2-optimized encoder binaries compiled with -O3 -flto in most cases & allow the user to install them with detailed instructions

• Remember encoding history and let you view your whole history or your most recent command

• Allow you to encode an entire directory of video files with the same settings

• Encode with x264, x265, aomenc, SVT-AV1-PSY, or rav1e, set a speed preset, CRF/quality value, FFmpeg parameters, and encoder parameters

• Generate Av1an encoding commands with the user's chosen settings & run them to encode a provided input video to an MKV output.

• Encode from scratch, or resume a previous rAV1ator CLI encode

• Engage with rich interactivity features like spinners, prompts, & dropdowns

• Automatically error check binaries with SHA256 hashes for security & convenience

Overall, it aims to provide an easy way to encode videos on the command line with helpful visual feedback. The interactive prompts help users pick encoding settings without needing deep encoding knowledge.

Installation

Installing rAV1ator CLI on its own is as simple as running the following two commands:

curl -sOJ https://raw.githubusercontent.com/gianni-rosato/rav1ator-cli/main/rav1ator-cli && chmod +x rav1ator-cli
sudo cp rav1ator-cli /usr/local/bin

rAV1ator CLI will not work properly if not installed in /usr/local/bin.

After it is properly installed, it will update itself in the future when updates become available.

Dependencies can be installed on Arch by running the following command:

yay -Syu openssl ffmpeg python mkvtoolnix-cli vapoursynth gum l-smash vapoursynth-plugin-lsmashsource av1an ffms2

Pre-compiled Binary Disclaimer

Binaries installed by rAV1ator CLI are downloaded directly from my repo here. In this repo's commit history, you can see that the commits where I added the ZSTD archives to this repo's bin/ directory are signed by my GPG key, verifying I made these commits and the binaries in that directory are the ones I intend to ship. The SHA256 hashes that are checked upon the decompression of each binary's respective archive have also been verifiably added by myself, ensuring that the hashes I committed must be identical to the file contents. This means if someone spoofs the URLs you are downloading from, the binary integrity is still checked manually by the script itself.

I strive to provide safe pre-compiled binary installation for everyone. That being said, it is always advisable to be cautious about the use of pre-compiled binaries on your system that are not from trusted sources. I consider myself a trusted source for the reasons above, but if you do not blindly trust my willingness to provide safe binaries forever with no malicious intent, you are entirely justified in your reasoning and you may be better off building from source.

Redistribution of the binaries I have compiled here is fair and just under as it pertains to the terms of the licenses attached to each binary. These can be found in the legal/ directory that is automatically downloaded alongside the binaries via rAV1ator CLI's binary installation, or within the bin/ directory of this repo.

Demos

If you want to learn more about AV1 encoding, check out AV1 Encoding for Dummies on the Codec Wiki.