Direct CLI Mode

Pass the input folder as a positional argument to run Shrinkr directly — no wizard.

Syntax

shrinkr <folder> [flags]

Examples

# Compress a folder to WebP at 500 KB (all defaults)
shrinkr ./photos

# Convert to AVIF at 300 KB target
shrinkr ./photos -f avif -s 300

# Custom output location
shrinkr ./photos -f webp -s 500 -o ./compressed-photos

# Recursive scan — include subfolders
shrinkr ~/Pictures -r -f webp -s 200

# All options at once
shrinkr ./photos -f avif -s 300 -q 80 --min-quality 55 --max-quality 85 -w 8 -o ./out

# JPEG output at high quality, large target
shrinkr ./raw-exports -f jpeg -s 2048 -q 95 --min-quality 85 --max-quality 98

Output

Shrinkr prints a live progress bar during compression, then a per-file summary and overall stats when done:

  Found 142 image(s)
  Target: 500 KB  |  Format: webp  |  Workers: 10

  ████████████████████░░░░ 83%

  ✓ photo_001.jpg   4.2 MB → 487 KB   (-88%)
  ✓ photo_002.jpg   3.8 MB → 412 KB   (-89%)
  ...

  142 images  |  142 succeeded  |  0 failed
  Total saved: 412 MB → 61 MB  (-85%)
  Time: 8.3s

Original files are never modified. Output goes to the folder specified by --output.