imageoptim-cli

Automates ImageOptim, ImageAlpha, and JPEGmini for Mac to make batch optimisation of images part of your automated build process.

ImageOptim-CLI

Automates ImageOptim, ImageAlpha, and JPEGmini for Mac to make batch optimisation of images part of your automated build process.

While other image optimization tools are available from the command line, ImageOptim-CLI exists because the current benchmarks suggest that ImageOptim, ImageAlpha and JPEGmini currently outperform those alternatives over lossless and lossy optimizations.

Check out this short video demo of ImageOptim-CLI to see how it works.

Jamie Mason / @fold_left.

Installation
- Manual Installation
- JPEGmini and support for assistive devices
Usage
Examples
Related projects
FAQs

Installation

ImageOptim-CLI is written in Shell and AppleScript, you don't need Node.js to run it. npm is suggested because it makes installation very convenient.

npm install -g imageoptim-cli

Manual Installation

You can install manually by downloading the latest zip then adding ImageOptim-CLI to your $PATH.

curl --output imageoptim-cli.zip https://codeload.github.com/JamieMason/ImageOptim-CLI/zip/1.14.8
unzip imageoptim-cli.zip
export PATH=$PATH:imageoptim-cli/bin

Saving somewhere in your home directory such as ~/imageoptim-cli is recommended, but not essential. Saving to /Applications is not recommended, do not do this.

JPEGmini and support for assistive devices

You may be presented with the following message the first time you run ImageOptim-CLI with the --jpeg-mini flag.

To automate JPEGmini we need to add Terminal.app (or iTerm.app etc) to the 'support for assistive devices' whitelist.

The JPEGmini OS X Apps don't include a command line API, so a real user is simulated by entering synthetic clicks and keyboard commands instead. This requires your permission and is easily set up in System Preferences as shown by these guides.

Usage

Usage: imageoptim [options]

Options:

  -d, --directory       directory of images to process
  -a, --image-alpha     pre-process PNGs with ImageAlpha.app *
  -j, --jpeg-mini       pre-process JPGs with JPEGmini.app **
  -m, --min-quality     pngquant min quality parameter
  -s, --skip-if-larger  pngquant use --skip-if-larger
  -q, --quit            quit all apps when complete
  -c, --no-color        disable color output
  -h, --help            display this usage information
  -e, --examples        display some example commands and uses
  -v, --version         display the version number
  --verbose             display detailed, per-file info on optimizations

*  http://pngmini.com
** https://itunes.apple.com/us/app/jpegmini/id498944723

Examples

Optimise a directory of images

This command will optimise all image files in your Awesome project.

imageoptim --directory ~/Sites/Awesome # [options]

Optimise a filtered set of images

This command will optimise just the .jpg files in your Awesome project.

find ~/Sites/Awesome -name '*.jpg' | imageoptim # [options]

Passing additional options

The long format for enabling options is as follows;

imageoptim --jpeg-mini --image-alpha --quit --no-color --directory path/to/images

The equivalent of the above in short format is as follows;

imageoptim -j -a -q -d -c path/to/images

Adding to git pre-commit hook

Adding the below to your_project/.git/hooks/pre-commit will run imageoptim-CLI each time you commit new and changed files into your project. Any files which aren't images will be ignored.

images=$(git diff --exit-code --cached --name-only --diff-filter=ACM -- '*.png' '*.jpg')
$(exit $?) || (echo "$images" | imageoptim && git add $images)