Skip to main content

Image Compressor

đŸ“ĻDesign & Content
💰

Costs

Monthly:Free
Annual:Free
🔑

Access

INTERNAL
ℹī¸

Tool created by pacing for optimal image compression

Purpose: Professional image compression and conversion tool with multiple distribution options for JPEG, PNG, WEBP, and AVIF formats.

Last verified: January 2026

Account Details​

  • Category: DESIGN_CONTENT
  • Account type: INTERNAL
  • Notes: Tool created by pacing for optimal image compression
  • Account owner: Ben Power
  • Repository: GitHub

Overview​

ImageMagick Pro Converter is a professional image compression and conversion tool developed by Pacing Agency. It offers multiple distribution options to suit different use cases, from development environments to end-user distribution. The tool supports multiple image formats, quality presets, batch processing, and includes an interactive before/after comparison preview.

Project Structure​

The repository contains three main distribution versions:

01-Development​

Main development version - Use for coding, testing, and adding features.

  • Requirements: Python 3.x+, ImageMagick, Pillow
  • Usage: python3 compressor.py (macOS/Linux) or python compressor.py (Windows)
  • Best for: Developers, power users, and Windows users (only cross-platform version)
  • Location: 01-Development/compressor.py
  • Platform Support: ✅ Windows, ✅ macOS, ✅ Linux

This is the master version of the script. All other versions are synced from this file. This is the only version that works on Windows.

02-AppleScript-Launcher​

Native Mac app launcher - Lightweight wrapper that runs the Python script.

  • Requirements: Python 3.14+, ImageMagick, Pillow
  • Usage: Double-click Image Compressor (AppleScript).app
  • Best for: Mac users with development tools installed
  • Location: 02-AppleScript-Launcher/
  • Platform Support: ❌ macOS only (not compatible with Windows)

Provides a native Mac application experience while still requiring the underlying dependencies.

04-Complete-Standalone​

Zero-dependency app - Everything included, works anywhere.

  • Requirements: None
  • Usage: Double-click Image Compressor Complete.app
  • Best for: End-user distribution and sharing (Mac only)
  • Location: 04-Complete-Standalone/
  • Platform Support: ❌ macOS only (not compatible with Windows)

Fully self-contained application with all dependencies bundled. Ideal for commercial distribution on macOS.

Features​

  • Multiple formats: JPEG, PNG, WEBP, AVIF
  • Quality presets: Low (30%), Medium (50%), High (80%)
  • Image resizing: Fixed width or percentage scaling
  • Before/after comparison: Interactive slider preview
  • Batch processing: Multiple files at once
  • Smart caching: Faster conversions after preview
  • Advanced options: PNG optimization, grayscale, sharpening
  • Flexible output: Same directory, custom folders, filename parameters

Which Version Should You Use?​

Use CaseRecommended VersionWhy
Development01-DevelopmentEasy to modify and debug
Windows users01-DevelopmentOnly cross-platform version
Mac power users02-AppleScript-LauncherNative app, small size
End-user sharing (Mac)04-Complete-StandaloneZero dependencies
Commercial distribution (Mac)04-Complete-StandaloneProfessional quality

Keeping Scripts Synced​

IMPORTANT: The main script (compressor.py) in 01-Development/ is the master version. Always sync after changes:

# After making changes to 01-Development/compressor.py
./sync-scripts.sh

# Then rebuild the apps as needed (see individual README files)

Never edit scripts directly in other folders - they get overwritten by the sync script.

Downloading from Repository​

git clone https://github.com/Pacing-Agency/imagecompressor.git
cd imagecompressor

Option 2: Download ZIP​

  1. Visit: https://github.com/Pacing-Agency/imagecompressor
  2. Click the green "Code" button
  3. Select "Download ZIP"
  4. Extract the ZIP file to your desired location

Option 3: Download Specific Version​

  • For Windows/Development: Download the 01-Development folder
  • For Mac (with dev tools): Download the 02-AppleScript-Launcher folder
  • For Mac (standalone): Download the 04-Complete-Standalone folder

Quick Start​

For Development (Windows/Mac/Linux)​

macOS/Linux:

cd "01-Development"
python3 compressor.py

Windows:

cd "01-Development"
python compressor.py

For Mac End Users​

  1. Download 04-Complete-Standalone/Image Compressor Complete.app
  2. Double-click and use immediately - no setup required

For Windows End Users​

See the Running on Windows section below.

Running on Windows​

Prerequisites​

Before running the Image Compressor on Windows, ensure you have the following installed:

  1. Python 3.x

    • Download from python.org
    • During installation, check "Add Python to PATH"
    • Tkinter is usually included with Python on Windows

  2. Pillow

    • Install via pip: pip install Pillow
    • Or: python -m pip install Pillow

  3. ImageMagick

    • Option 1 (Recommended): Download installer from ImageMagick.org
      • Choose the Windows binary release
      • During installation, check "Add application directory to your system path"
    • Option 2: Use Chocolatey: choco install imagemagick
    • Verify installation: Open Command Prompt and run magick -version

Installation Steps​

  1. Download the repository

    git clone https://github.com/Pacing-Agency/imagecompressor.git
    cd imagecompressor

    Or download the ZIP and extract it.

  2. Navigate to the development folder

    cd "01-Development"

  3. Install Python dependencies

    pip install Pillow

  4. Verify ImageMagick is accessible

    magick -version

    If this command fails, you may need to:

    • Restart your terminal/Command Prompt
    • Add ImageMagick to your system PATH manually
    • Reinstall ImageMagick with the PATH option enabled

Running the Application​

Once all prerequisites are installed:

python compressor.py

Or if you have multiple Python versions:

python3 compressor.py

The application window should open, allowing you to:

  • Select images to compress
  • Choose quality presets (Low, Medium, High)
  • Adjust resize options
  • Preview before/after comparisons
  • Process images in batch

Troubleshooting​

Issue: "ImageMagick not found" error

  • Ensure ImageMagick is installed and in your system PATH
  • Restart your terminal after installing ImageMagick
  • Try running magick -version in Command Prompt to verify

Issue: Tkinter not available

  • Reinstall Python and ensure Tkinter is included
  • On some Python distributions, you may need: pip install tk

Issue: Application won't start

  • Check Python version: python --version (should be 3.x)
  • Verify Pillow installation: python -c "import PIL; print(PIL.__version__)"
  • Check for error messages in the terminal

Windows-Specific Notes​

  • The application uses standard Windows file dialogs
  • Mouse wheel scrolling works automatically on Windows
  • File paths use Windows-style backslashes (handled automatically by Python)
  • The standalone .app versions (02 and 04) are macOS-only and won't work on Windows
  • For Windows distribution, you would need to create a Windows executable using PyInstaller

Creating a Windows Executable (Optional)​

If you want to create a standalone Windows executable:

  1. Install PyInstaller:

    pip install pyinstaller

  2. Build the executable:

    pyinstaller --onefile --windowed --name "Image Compressor" compressor.py

  3. The executable will be in the dist folder

Note: You'll still need to ensure ImageMagick is installed on the target Windows machine, or bundle it with the executable (more complex setup).

Build Requirements​

For building the standalone versions:

macOS:

  • Python 3.14+ with Tkinter
  • PyInstaller: pip install pyinstaller
  • Pillow: pip install Pillow
  • ImageMagick: brew install imagemagick

Windows:

  • Python 3.x with Tkinter
  • PyInstaller: pip install pyinstaller
  • Pillow: pip install Pillow
  • ImageMagick: Download from ImageMagick.org or choco install imagemagick

Repository​

License​

This project is open source. Free to modify and distribute.