Shell HTML C Makefile
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

Crunch PNG file optimizationCrunch PNG file optimization Crunch PNG file optimization

About

Crunch is a macOS tool for lossy PNG image file optimization. It combines selective bit depth, color type, and color palette reduction with zopfli DEFLATE compression algorithm encoding using embedded versions of the pngquant and zopflipng PNG optimization tools. This approach leads to a significant file size gain relative to lossless approaches at the expense of a relatively modest decrease in image quality (see example images below).

Historical benchmarks with the files included in Cédric Louvrier's PNG Test Corpus versus other commonly used PNG optimization software are available in BENCHMARKS.md.

Crunch PNG image optimization is available through:

  • Crunch - a macOS drag and drop GUI tool
  • Crunch Image(s) - a macOS right click menu service for PNG images selected in the Finder

Install Crunch

Want to kick the tires? Choose one of the methods below:

1. Install with Hombrew Cask Package Manager (Recommended)

$ brew cask install crunch

Note that you must use brew cask install and not brew install!

Following your install you can upgrade to the latest version with:

$ brew cask uninstall crunch && brew cask install crunch

2. Install with dmg Installer

Download the dmg installer, click it, and drag the Crunch icon to your Applications directory.

Upgrade by following the same instructions and allowing the new version to replace the old version on your system.

Install Crunch Image(s) macOS Service

Crunch PNG image optimization is available through the macOS right click menu service "Crunch Image(s)".

Please see SERVICE.md for documentation.

Contents

Examples

The following examples demonstrate the benefits and disadvantages of the current iteration of Crunch's aggressive space saving lossy optimization. In many cases, Crunch's optimization minimizes file size with an imperceptible decrease in image quality. In some cases, Crunch's optimization can significantly decrease the quality. For example, the horizon line + clouds in the prairie photo below. Experiment with the image types used and please submit a report with examples of any images where the image quality falls short of expectations for production-ready files.

Photography Examples

Cat Image

  • Original Size: 583,398 bytes
  • Optimized Size: 195,491 bytes
  • DSSIM similarity score: 0.001481
Original

cat example pre optimization

Optimized

cat example post optimization

Sun's Rays

  • Original Size: 138,272
  • Optimized Size: 64,947
  • DSSIM similarity score: 0.000913
Original

sun rays example pre optimization

Optimized

sun rays example pre optimization

Prairie Image

  • Original Size: 196,794 bytes
  • Optimized Size: 77,595 bytes
  • DSSIM similarity score: 0.002988
Original

prarie example pre optimization

Optimized

prarie example post optimization

Illustration Examples

Robot Image

  • Original Size: 197,193 bytes
  • Optimized Size: 67,632 bytes
  • DSSIM similarity score: 0.000163
Original

robot example pre optimization

Optimized

robot example post optimization

Color Circle Image

  • Original Size: 249,251 bytes
  • Optiimized Size: 68,309 bytes
  • DSSIM similarity score: 0.002575
Original

colors example pre optimization

Optimized

colors example post optimization

Flowers Image

  • Original Size: 440,126 bytes
  • Optimized Size: 197,045 bytes
  • DSSIM similarity score: 0.000481
Original

748

Optimized

748

All images above were obtained from Pixabay and are dedicated to the public domain under the CC0 Public Domain Dedication.

Usage

Drag and drop your PNG images onto the Crunch window:

Crunch PNG image optimization usage

Your optimized file is saved in the same directory as the original file with the modified path [original filename]-crunch.png.

Issues

Please create a new issue report on the Github issue tracker.

Licenses

Crunch is licensed under the MIT license.

Embedded Software

pngquant is licensed under the Gnu General Public License, version 3. The pngquant source code is available here.

zopflipng is licensed under the Apache License, Version 2.0. The zopflipng source code is available here.

See the LICENSE.md document for details and additional licensing information for this project.

Acknowledgments

Crunch is a simple tool that makes excellent, free, open source software built by others accessible through a GUI. The hard work on the optimization engines that run Crunch has been performed by: