Image optimization for Grunt using imgo
JavaScript
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
tasks
test
.editorconfig
.gitignore
.jshintrc
.npmignore
Contributing.md
Gruntfile.js
License.md
Readme.md
package.json

Readme.md

Image optimization for Grunt using imgo

No Maintenance Intended

Installation

This plugin requires Grunt 0.4.

Install imgo (see How to install imgo on OS X below for instructions).

npm install grunt-imgo --save-dev

Add to your Gruntfile.js:

grunt.loadNpmTasks('grunt-imgo');

Then add section named imgo inside grunt.initConfig(). See next section for details.

Parameters

src string|array

Images list: PNG, GIF or JPEG. String or array. Wildcards are supported.

dest string

Destination path for images copying before optimizing.

icons: {
    src: 'static/dev/img/*.*',
    dest: 'static/build/img/'
}

options string

Any options you want to pass to imgo.

icons: {
    src: 'icons/*.png',
    options: '-m -b'
}

skip boolean

If true task will not be ran. In example, you can skip imgo on Windows (becase of difficult installation):

skip: require('os').platform() === 'win32'

Gruntfile Example

module.exports = function(grunt) {
    grunt.initConfig({
        imgo: {
            icons: {
                src: 'icons/*.png'
            }
        }
    });
    grunt.loadNpmTasks('grunt-imgo');
    grunt.registerTask('default', ['imgo']);
};

How to install imgo on OS X

Install Homebrew.

Run following commands in terminal:

brew install exiftool imagemagick optipng libjpeg gifsicle

formulas='pngout.rb  defluff.rb cryopng.rb imgo.rb'
for package in $formulas
do
  brew install "https://raw.github.com/imgo/imgo-tools/master/Formula/"$package
done

You may need to use sudo for brew, depending on your setup.

Release History

2013-06-18 v0.1.1

  • dest option (by @smolnikov).
  • Fix options: cannot parse several keys.
  • Verbose output of imgo command.

2013-02-18 v0.1.0

  • Grunt 0.4 support.
  • file option renamed to src.

License

The MIT License, see the included License.md file.