Optimize images for the web in seconds

Features • Installation • Usage • Finder Integration • Configuration

✨ WebP Conversion - Automatically converts images to WebP format for optimal web performance
📐 Smart Resizing - Limits maximum dimensions to 1920x1080 while maintaining aspect ratio
🎯 Size Optimization - Keeps files under 500KB with intelligent quality adjustment
🖼️ Quality Preservation - Maintains visual quality using binary search for optimal compression
🚀 Batch Processing - Process entire folders with a single command
🍎 macOS Native - Finder Quick Actions and Droplet app included
⚡ Fast & Simple - One command, no configuration needed

brew tap jack/quick-compress
brew install quick-compress

curl -fsSL https://raw.githubusercontent.com/jack/quick-compress/main/install.sh | bash

# Clone the repository
git clone https://github.com/jack/quick-compress.git

# Run the install script
cd quick-compress
./install.sh

• macOS or Linux
• ImageMagick (installed automatically by the install script)

compress path/to/image.jpg

Output: Creates path/to/image.webp (235KB from 2.5MB original)

compress path/to/folder

Output: Converts all images in the folder to optimized WebP files

• JPG / JPEG
• PNG
• GIF
• BMP
• TIFF

All formats are converted to WebP for maximum compression and web compatibility.

1. Right-click any image or folder in Finder
2. Go to Services → Compress Images for Web
3. Get instant optimization!

1. Find "Compress Images" app in your Applications folder
2. Drag any image or folder onto the app icon
3. Or double-click to use the file picker

1. Open Finder
2. Hold ⌘ Command and drag "Compress Images" app to the toolbar
3. Select files and click the button anytime!

Edit the script to customize settings:

# Open the script for editing
nano $(which compress)

Modify these variables at the top:

MAX_WIDTH=2560      # Change max width
MAX_HEIGHT=1440     # Change max height
MAX_SIZE=1048576    # Change to 1MB (in bytes)
QUALITY=90          # Change initial quality

1. Analyze - Checks image dimensions and current file size
2. Resize - Scales down images exceeding max dimensions
3. Convert - Converts to WebP at 85% quality
4. Optimize - If file > 500KB, uses binary search to find best quality under limit
5. Save - Outputs optimized WebP in the same location

# Optimize website assets
compress ~/MyWebsite/images/

# Prepare photos for blog
compress ~/Desktop/vacation-photos/

# Optimize logo
compress ~/Downloads/logo.png

Make sure your shell configuration was reloaded:

source ~/.zshrc  # or ~/.bashrc

Or use the full path:

~/.local/bin/compress image.jpg

Install ImageMagick:

# macOS
brew install imagemagick

# Ubuntu/Debian
sudo apt-get install imagemagick

# Fedora
sudo dnf install imagemagick

Make sure the script is executable:

chmod +x ~/.local/bin/compress

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Distributed under the MIT License. See LICENSE for more information.

• ImageMagick for the powerful image processing
• Inspired by the need for simple, fast web optimization

Made with ❤️ for the web development community