grunt-cwebp

Convert JPG and PNG images to WebP with grunt task.

Install

This plugin requires Grunt ~0.4.1

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

$ npm install --save-dev grunt-cwebp

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-cwebp');

Usage

Please see following gruntfile.js example.

module.exports = function (grunt) {
  grunt.initConfig({
    cwebp: {
      static: {
        files: { 
          'dist/img-png.webp': 'src/img.png',
          'dist/img-jpg.webp': 'src/img.jpg',
          'dist/img-gif.webp': 'src/img.gif'
        }
      },
      dynamic: {
        options: {
          q: 100,
          m: 6,
          lossless: true
        },
        files: [{
          expand: true,
          cwd: 'src/', 
          src: ['**/*.{png,jpg,gif}'],
          dest: 'dist/'
        }]
      }
    }
  });

  grunt.loadNpmTasks('grunt-cwebp');
};

Files are processed with node-cwebp-bin, you can also pass any native lib options, like q. Native lib options which normally require no arguments (such as lossless or low_memory) can be passed in by setting their respective arguments to true.

Options

sameExt

Type: Boolean Default: false

Set to true, if you want to leave original file extension after converting to webp.

License

MIT: http://1000ch.mit-license.org