imagemin plugin for guetzli
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

imagemin-guetzli Build Status

Guetzli imagemin plugin

Guetzli is a JPEG encoder that aims for excellent compression density at high visual quality. Guetzli-generated images are typically 20-30% smaller than images of equivalent quality generated by libjpeg. Guetzli generates only sequential (nonprogressive) JPEGs due to faster decompression speeds they offer.


$ npm install --save imagemin-guetzli


const imagemin = require('imagemin');
const imageminGuetzli = require('imagemin-guetzli');

imagemin(['images/*.{png,jpg}'], 'build/images', {
    use: [
        imageminGuetzli({quality: 95})
}).then(() => {
    console.log('Images optimized');

Usage (gulp-imagemin)

const gulp = require('gulp');
const imagemin = require('gulp-imagemin');
const imageminGuetzli = require('imagemin-guetzli');

gulp.task('default', () =>


Guetzli uses a large amount of memory. You should provide 300MB of memory per 1MPix of the input image.

Guetzli uses a significant amount of CPU time. You should count on using about 1 minute of CPU per 1MPix of input image.

Guetzli assumes that input is in sRGB profile with a gamma of 2.2. Guetzli will ignore any color-profile metadata in the image.

Guetzli is designed to work on high quality images (e.g. that haven't been already compressed with other JPEG encoders). While it will work on other images too, results will be poorer. You can try compressing an enclosed sample high quality image.

Guetzli converts PNG/JPG to JPG. When using this plugin or guetzli-bin CLI, the original filename+ext is used as the output, although the image format has changed. You have to rename the file with the correct file extension (JPG) yourself afterwards.




Type: object


Type: number (0–100)
Default: 95

Set quality in units equivalent to libjpeg quality. As per guetzli function and purpose, it is not recommended to go below 84.

Please note that JPEG images do not support alpha channel (transparency). If the input is a PNG with an alpha channel, it will be overlaid on black background before encoding.


Type: number
Default: 6000

Memory limit in MB. Guetzli will fail if unable to stay under the limit. Note: Currently, in imagemin-guetzli, this will fail silently as the error is not passed along.


Type: boolean

Do not limit memory usage.


MIT © imagemin