diegosouzapw Image Optimizer
Compress and optimize images for web delivery, similar to Squoosh.
Quick Start
# Ensure dependencies are installed
scripts/install-deps.sh
# Optimize images
scripts/imgopt.sh [OPTIONS] <files or directories>
Common Use Cases
Optimize a single image
scripts/imgopt.sh photo.jpg
Compress all images in a folder
scripts/imgopt.sh images/
Resize and compress for web (recommended for large images)
scripts/imgopt.sh -q 80 -w 1920 images/
Create WebP versions (best compression for modern browsers)
scripts/imgopt.sh --webp images/
Process recursively and keep originals
scripts/imgopt.sh -r --keep --webp ./website/images/
Output to a different directory
scripts/imgopt.sh -o optimized/ *.jpg *.png
Preview what would happen (dry run)
scripts/imgopt.sh -n -r images/
Options Reference
| Option | Description | Default |
|---|---|---|
-q, --quality N |
Quality level 1-100 | 80 |
-w, --max-width N |
Maximum width in pixels | unlimited |
-h, --max-height N |
Maximum height in pixels | unlimited |
-o, --output DIR |
Output directory | in-place |
--webp |
Also create WebP versions | off |
--keep |
Keep originals (save as .opt.ext) | off |
-r, --recursive |
Process directories recursively | off |
-n, --dry-run |
Show what would be done | off |
-v, --verbose |
Show detailed progress | off |
Supported Formats
- Input: JPEG, PNG, GIF, BMP, TIFF
- Output: Same format (optimized) + optional WebP
Recommended Settings by Use Case
| Use Case | Command |
|---|---|
| Blog images | -q 80 -w 1200 --webp |
| Hero/banner images | -q 85 -w 1920 --webp |
| Thumbnails | -q 75 -w 400 |
| E-commerce products | -q 85 -w 1000 --webp |
| Maximum compression | -q 60 -w 1920 --webp |
Tips
- Always test on copies first - Use
--keepor-o output/until you're happy with results - WebP is best for web - Creates files typically 25-35% smaller than optimized JPEG
- Quality 80 is a good default - Below 70 you may notice artifacts
- Resize matters most - A 4000px image resized to 1920px will be much smaller regardless of compression
See references/REFERENCE.md for detailed technical information.