WebP Batch

Batch-convert images to WebP from the command line with fast, consistent quality presets.

<!-- Suggested badges: npm version, build status, test coverage, license, platform support -->

Features

• Convert entire directories in one command
• Support for PNG, JPEG, TIFF, and other common image formats
• Built-in low, medium, high, and lossless quality presets
• Recursive directory processing
• Preserve source directory structure
• Skip unchanged or existing files
• Control output location, dimensions, and metadata
• Preview operations with dry-run mode
• Cross-platform CLI support

Quickstart

Install

npm install --global webp-batch

First run

Convert all supported images in a directory using the default medium preset:

webp-batch ./images

Converted files are written to ./webp by default.

Usage

webp-batch <input> [options]

Convert a directory

webp-batch ./images

Choose an output directory

webp-batch ./images --output ./public/assets

Use a quality preset

webp-batch ./images --preset high

Available presets:

low
medium
high
lossless

Convert directories recursively

webp-batch ./images --recursive

Convert individual files

webp-batch photo.jpg logo.png banner.tiff --output ./webp

Resize images

webp-batch ./images --width 1600 --height 900

Omit either dimension to preserve the original aspect ratio:

webp-batch ./images --width 1200

Skip existing output files

webp-batch ./images --skip-existing

Preview without writing files

webp-batch ./images --dry-run

Combine options

webp-batch ./images \
  --output ./public/webp \
  --preset high \
  --recursive \
  --skip-existing

Configuration

Options may be provided as CLI flags or in a .webp-batch.json file in the current directory.

| Option | CLI flag | Default | Description | |---