ImageOptimizer

This gem allows you to simply optimize images via jpegoptim or OptiPNG.

Tested against ruby 2.0.x, 2.1.x, 2.2.x, 2.3.x, and ruby-head

Build Status Dependency Status Code Climate Coverage Status Gem Version

Installation

This gem uses the following utilities for optimizing images:

  1. jpegoptim, which can be installed from freecode.com

  2. OptiPNG, which can be installed from sourceforge.net

Or install the utilities via homebrew:

$ brew install optipng jpegoptim

Then add this line to your application's Gemfile:

gem 'image_optimizer'

And then execute:

$ bundle

Or install it yourself as:

$ gem install image_optimizer

Usage

Optimize PNG or GIF formats:

OptiPNG is a PNG optimizer that recompresses image files to a smaller size without losing any information and performs PNG integrity checks and corrections.

ImageOptimizer.new('path/to/file.png').optimize

Optimize JPEG formats:

jpegoptim provides lossless optimization for JPEG files based on optimizing the Huffman tables. All jpegs will be progressively optimized for a better web experience

ImageOptimizer.new('path/to/file.jpg').optimize

Optimization Options

Quiet optimization

To have optimization performed in quiet mode without logging progress, an optional quiet parameter may be passed. Default is false.

ImageOptimizer.new('path/to/file.jpg', quiet: true).optimize
Lossy JPEG optimization

Pass an optional quality parameter to target a specific lossy JPG quality level (0-100), default is lossless optimization. PNGs will ignore the quality setting.

ImageOptimizer.new('path/to/file.jpg', quality: 80).optimize
Custom PNG optimization quality

By default, optipng is called with the -o7 flag, which controls the level of optimization. This default level generates the most optimized results, at the expense of very high execution times, so you may want to lower it if your server can't handle it.

You can pass an optional level parameter to change this value. the JPEG optimizer will ignore the value.

ImageOptimizer.new('path/to/file.png', level: 3).optimize
Don't Remove metadata from PNG

By default, optipng is called with the -strip all flag, which removes all the level of metadata. This default generates the most optimized results.

You can skip removing the meta data by changing the strip_metadata parameter to false. the JPEG optimizer will ignore the value.

ImageOptimizer.new('path/to/file.png', strip_metadata: false).optimize
Use identify

Pass an optional identify parameter to identify file types using ImageMagick or GraphicsMagick identify instead of the filename extension, default is false.

ImageOptimizer.new('path/to/file.jpg', identify: true).optimize

Set bin directories

Optionally set binary directories with the OPTIPNG_BIN, JPEGOPTIM_BIN and IDENTIFY_BIN environment variables.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request