Skip to content

The cli tool that allows you handle WebP Images more easily.

License

Notifications You must be signed in to change notification settings

nonsugarless/webp-converter

Repository files navigation

@nonsugarless/webp-converter

Build Status GitHub license

"@nonsugarless/webp-converter" is the wrapper of webp-converter that allows you convert and delete WebP Images more easily.

Features

You can convert images to WebP Images and delete unnecessary WebP Images automatically.

Installation

yarn add -D @nonsugarless/webp-converter

or

npm install --save-dev @nonsugarless/webp-converter

Usage

Convert all images

$ webp-cli convert

Start to watch images directory

$ webp-cli watch

WebP Images will be converted automatically when images are added, changed and deleted.

Delete converted WebP Images

$ webp-cli clean

Delete converted WebP Images whose original one no longer exists in originalDir

$ webp-cli clean --all

Delete all WebP Images from destDir

Default configuration

Prop Default Description
destDir "./htdocs/img/" Path to output images directory from project root
originalDir "./htdocs/img/" Path to input images directory from project root
targetExt ".+(jpg|jpeg|png|gif)" Extension of convert files
excludeFileNames ["apple-touch-icon.png"] Array of filenames that you don't want to convert
excludeDirNames [] Array of relative path from originalDir that you don't want to convert
webpConverterOption "-q 85" WebP convert options
webpConverterGifOption "-q 85" Gif WebP convert options

Optional configuration

You can use an optional configuration .webpconverterrc file in JSON or YAML format or webpconverter.config.js file exporting a JS object by setting it project root directory. See cosmiconfig docs for more details.

{
	"destDir": "./dest/img/",
	"originalDir": "./src/img/",
	"targetExt": ".+(jpg|png|gif)",
	"excludeFileNames": ["apple-touch-icon.png", "og-image.png"],
	"excludeDirNames": ["foo/bar"], // ignore all files below ./dest/img/foo/bar/
	"webpConverterOption": "-q 75 -sharp_yuv -m 5 -mt",
	"webpConverterGifOption": "-q 90 -m 5 -mt"
}

API

Also you can use this as Node.js functions.

import { convertAll, watch, clean, cleanAll } from '@nonsugarless/webp-converter';

convertAll();

It will be applied your configuration.

License

MIT