Build from source

Requires the Rust toolchain (1.87+, edition 2024).

The core build needs nothing extra:

cargo build --release

HEIC/HEIF and video each link against a native library. For each one you want, run its setup script once, then build with the matching feature flag.

HEIC / HEIF libheif

./scripts/setup-heif.sh       # setup-heif.ps1 on Windows
cargo build --release --features heif

Video FFmpeg

./scripts/setup-av.sh      # setup-av.ps1 on Windows
cargo build --release --features av

For the full default build, set up both, then combine the flags:

cargo build --release --features heif,av

Prebuilt downloads already bundle HEIF and video. See the README for full per-OS setup.