imagemin

What is imagemin?

The imagemin npm package is a powerful tool for image compression and optimization. It allows developers to reduce the size of images without losing quality, which can significantly improve the performance of web applications by reducing load times.

What are imagemin's main functionalities?

Basic Image Compression

This code demonstrates how to use imagemin to compress JPEG and PNG images. The images are taken from the 'images' directory and the compressed versions are saved in the 'build/images' directory. The quality of JPEG images is set to 75, and the quality of PNG images is set between 60% and 80%.

const imagemin = require('imagemin');
const imageminMozjpeg = require('imagemin-mozjpeg');
const imageminPngquant = require('imagemin-pngquant');

(async () => {
    const files = await imagemin(['images/*.{jpg,png}'], {
        destination: 'build/images',
        plugins: [
            imageminMozjpeg({quality: 75}),
            imageminPngquant({quality: [0.6, 0.8]})
        ]
    });

    console.log(files);
})();

GIF Optimization

This code demonstrates how to optimize GIF images using imagemin. The GIF images are taken from the 'images' directory and the optimized versions are saved in the 'build/images' directory. The optimization level is set to 3, which is the highest level of optimization.

const imagemin = require('imagemin');
const imageminGifsicle = require('imagemin-gifsicle');

(async () => {
    const files = await imagemin(['images/*.gif'], {
        destination: 'build/images',
        plugins: [
            imageminGifsicle({optimizationLevel: 3})
        ]
    });

    console.log(files);
})();

SVG Optimization

This code demonstrates how to optimize SVG images using imagemin. The SVG images are taken from the 'images' directory and the optimized versions are saved in the 'build/images' directory. The SVGO plugin is configured to keep the viewBox attribute and not to remove IDs.

const imagemin = require('imagemin');
const imageminSvgo = require('imagemin-svgo');

(async () => {
    const files = await imagemin(['images/*.svg'], {
        destination: 'build/images',
        plugins: [
            imageminSvgo({
                plugins: [
                    {removeViewBox: false},
                    {cleanupIDs: false}
                ]
            })
        ]
    });

    console.log(files);
})();

Other packages similar to imagemin

sharp

Sharp is a high-performance image processing library that supports various image formats. It is known for its speed and efficiency, making it a popular choice for image resizing, cropping, and format conversion. Unlike imagemin, which focuses on compression and optimization, sharp provides a broader range of image manipulation functionalities.

jimp

Jimp is a pure JavaScript image processing library that does not require any external dependencies. It supports a wide range of image manipulation features, including resizing, cropping, and color adjustments. While imagemin is primarily used for image compression, Jimp offers a more comprehensive set of image editing tools.

image-webpack-loader

Image-webpack-loader is a loader for webpack that optimizes images during the build process. It uses imagemin under the hood but integrates seamlessly with webpack, making it a convenient choice for developers who are already using webpack for their build process. It provides similar functionalities to imagemin but is designed to work specifically within the webpack ecosystem.

README

imagemin

Minify images seamlessly with Node.js

Install

$ npm install --save imagemin

Usage

var Imagemin = require('imagemin');

var imagemin = new Imagemin()
    .src('foo.jpg')
    .dest('foo-optimized.jpg')
    .use(Imagemin.jpegtran({ progressive: true }));

imagemin.optimize(function (err, file) {
    console.log(file);
    // => { contents: <Buffer 89 50 4e ...>, mode: '0644' }
});

API

new Imagemin()

Creates a new Imagemin instance.

.use(plugin)

Add a plugin to the middleware stack.

.src(file)

Set the file to be optimized. Can be a Buffer or the path to a file.

.dest(file)

Set the destination to where your file will be written. If you don't set any destination the file won't be written.

.optimize(cb)

Optimize your file with the given settings.

.run(file, cb)

Run all middleware plugins on your file.

Plugins

The following plugins are bundled with imagemin:

• gifsicle — Compress GIF images.
• jpegtran — Compress JPG images.
• optipng — Lossless compression of PNG images.
• pngquant — Lossy compression of PNG images.
• svgo — Compress SVG images.

.gifsicle()

Compress GIF images.

var Imagemin = require('imagemin');

var imagemin = new Imagemin()
    .use(Imagemin.gifsicle({ interlaced: true }));

.jpegtran()

Compress JPG images.

var Imagemin = require('imagemin');

var imagemin = new Imagemin()
    .use(Imagemin.jpegtran({ progressive: true }));

.optipng()

Lossless compression of PNG images.

var Imagemin = require('imagemin');

var imagemin = new Imagemin()
    .use(Imagemin.optipng({ optimizationLevel: 3 }));

.pngquant()

Lossy compression of PNG images.

var Imagemin = require('imagemin');

var imagemin = new Imagemin()
    .use(Imagemin.pngquant());

.svgo()

Compress SVG images.

var Imagemin = require('imagemin');

var imagemin = new Imagemin()
    .use(Imagemin.svgo());

CLI

$ npm install --global imagemin

$ imagemin --help

Usage
  $ imagemin <file>
  $ cat <file> | imagemin

Example
  $ imagemin foo.png > foo-optimized.png
  $ cat foo.png | imagemin > foo-optimized.png

Options
  -i, --interlaced                    Extract archive files on download
  -o, --optimizationLevel <number>    Path to download or extract the files to
  -p, --progressive                   Strip path segments from root when extracting

Related

• imagemin-app
• gulp-imagemin
• grunt-contrib-imagemin

License

MIT © Kevin Mårtensson