compress-images-cli

English | 中文

A command-line tool for quickly compressing images in bulk without losing quality.

• Achieves compression efficiency of 50% - 70% while preserving image quality.
• Supports recursive compression of all images in a folder.
• Supports batch replacement or export of compressed image files.
• Supports avoiding redundant compression.
• Provides compression result display.

Quick Start

compress-images-cli # Compress images in the current directory and replace the original files.
compress-images-cli images  # Compress images in the "images" folder and replace the original files.
compress-images-cli logo.png -o logo-new.png  # Compress "logo.png" image and export it as "logo-new.png" (the original image remains unchanged).
compress-images-cli images -o imagesDir # Compress all image files in the "images" folder and export them to the "imagesDir" folder (the original images remain unchanged, and the new folder maintains the same file structure).

Installation

Use npx for temporary installation or install globally.

Using npx

npx compress-images-cli <filename or dirname> [OPTIONS]

Global Installation

Using npm

npm install -g compress-images-cli

Using yarn

yarn global add compress-images-cli

After installation, you can check if it was successful by running the following command:

compress-images-cli -v

Usage

compress-images-cli <filename or directory> [OPTIONS]

-v, --version          Display the current version number
-o, --output <output>  Specify the output directory or image name
-m, --max [max]        Maximum number of tasks processed simultaneously (higher values increase speed)
-a, --all              If specified, previously compressed images from the command line will be compressed again (the default behavior is to avoid redundant compression)
-h, --help             View the help information

-m Specify the maximum number of tasks processed simultaneously. You can set a larger value to improve processing speed (this will consume more memory).

Examples

compress-images-cli images  # Compress images in the "images" folder and replace the original files.
compress-images-cli logo.png -o logo-new.png  # Compress "logo.png" image and export it as "logo-new.png" (the original image remains unchanged).
compress-images-cli images -o imagesDir # Compress all image files in the "images" folder and export them to the "imagesDir" folder (the original images remain unchanged, and the new folder maintains the same file structure).
compress-images-cli images -m 30 # Compress images in the "images" folder and replace the original files, with a maximum of 30 tasks processed simultaneously.