Interactive Wizard

Running shrinkr with no arguments launches an interactive terminal wizard that guides you through all settings step by step.

shrinkr

Wizard Steps

Step 1 — Select image folder

Shrinkr scans your current directory and nearby sibling folders for images. If any are found, they appear as quick-select options. You can also browse for a folder via the native macOS Finder dialog, or type a path manually.

If no folders are detected nearby, you'll see two options:

• Browse for folder… — opens a Finder dialog
• Enter folder path manually… — type or paste a path

Tip: You can drag a folder from Finder into the terminal window and paste its path.

Step 2 — Output format

Choose the format for your compressed images:

Step 3 — Compression preset

Step 4 — Custom settings (if Custom preset selected)

If you chose Custom, you'll be asked to enter:

• Target file size (KB) — images will be compressed to fit under this size
• Initial quality (1–100) — first attempt before binary search kicks in
• Min quality (1–100) — compression will never go below this floor
• Max quality (1–100) — compression will never exceed this ceiling
• Worker count — defaults to your CPU core count (auto-detected)

Step 5 — Output folder

Choose where to save compressed images:

• compressed/ (default) — created in the current working directory
• Browse for a custom location — opens Finder to pick a parent directory, then name the output folder

Step 6 — Confirm

A summary is shown before running:

  Input:    ./photos
  Images:   142 found
  Format:   webp
  Target:   500 KB
  Quality:  85 (range 60–90)
  Workers:  10
  Output:   compressed

Confirm with Let's go! or go back with Cancel.

Keyboard Controls