Documentation

Usage

pixjet <input-dir> --out <output-dir> [flags]
FlagDefaultMeaning
--quality N82Target quality for lossy formats, 1–100.
--max-width PXoffDownscale anything wider than this, keeping aspect ratio.
--format keep|webp|jpegkeepConvert everything to one format, or keep the format of each file.
--jobs NcoresNumber of parallel workers.
--planoffReport only; write nothing.
--in-placeoffReplace originals. Asks for confirmation unless --yes is given.
--keep-metaoffKeep all EXIF/XMP metadata.

Exit codes

CodeMeaning
0All files processed.
1Some files failed; see the summary.
2Bad arguments.

Config file

Flags can live in .pixjet.toml next to the input directory:

quality = 78
max_width = 1600
format = "webp"
exclude = ["raw/**", "*.gif"]

Limits

HEIC and AVIF are not supported yet. Files larger than 200 megapixels are skipped with a warning.