grav1synth

Crates.iograv1synth
lib.rsgrav1synth
version0.1.0-beta.7
sourcesrc
created_at2022-07-10 18:46:02.557527
updated_at2024-05-11 11:56:21.766391
descriptionGrain Synth analyzer and editor for AV1 files
homepage
repositoryhttps://github.com/rust-av/grav1synth
max_upload_size
id623253
size4,038,760
Josh Holmer (shssoichiro)

documentation

README

Grav1synth

docs.rs Crates.io LICENSE

Grain Synth analyzer and editor for AV1 files

Build

  • Prerequisites:
    • ffmpeg headers
    • Rust compiler
  • Pull the repo
  • Run cargo build --release
  • Copy the binary from target/release/grav1synth to wherever you want

Usage

grav1synth inspect my_encode.mkv -o grain_file.txt

Reads my_encode.mkv and outputs a film grain table file at grain_file.txt

grav1synth apply my_encode.mkv -o grainy_encode.mkv -g grain_file.txt

Reads my_encode.mkv, adds film grain to it based on grain_file.txt, and outputs the video to grainy_encode.mkv

grav1synth generate my_encode.mkv -o grainy_encode.mkv --iso 400 --chroma

Reads my_encode.mkv, adds photon-noise-based film grain to it based on the strength provided by --iso (up to 6400), and outputs the video to grainy_encode.mkv. By default applies grain to only the luma plane. --chroma enables grain on chroma planes as well.

grav1synth remove my_encode.mkv -o clean_encode.mkv

Reads my_encode.mkv, removes all synthesized film grain, and outputs the video at clean_encode.mkv

grav1synth diff my_source.mkv denoised_source.mkv -o grain_file.txt

Compares my_source.mkv and denoised_source.mkv and generates a film grain table at grain_file.txt based on the difference between them. This will provide the most accurate estimation of source film grain.

Known Issues

  • There have been reports that certain videos will fail to apply film grain properly. This is likely related to aomenc's --keyframe-filtering=2.
Commit count: 101

cargo fmt