MicroPng CLI.

Professional image compression for your terminal. Fast, local, and recursive.

Now on NPM & Homebrew

Powerful Features, Zero Compromise.

The MicroPng CLI brings professional-grade image optimization to your build pipelines and local development environment. Built for speed and reliability.

NPM / Bun / Yarn
$npm install -g micropng-cli
Homebrew
$brew install SahilFruitwala/tap/micropng-cli
Run instantly (NPX)
$npx micropng-cli --help
micropng-cli
# Processing 148 images recursively...
➜SUCCESSOptimized image-24.pngSaved 42% (1.2 MB)
➜SUCCESSbanner-large.webpSaved 68% (4.5 MB)
➜SUCCESSlogo-transparent.pngSaved 12% (15 KB)
Total Stats:
Files Processed: 148
Time Taken: 4.2s
Total Space Saved: 124.5 MB

Key Features

Blazing Fast

Parallel processing with smart concurrency control to saturate your CPU without crashing.

Deeply Recursive

Scans folders and subfolders, maintaining your directory structure perfectly.

Safety First

Atomic overwrites: original files are only replaced if the compressed version is actually smaller.

Universal Formats

Full support for JPEG, PNG, WebP, and AVIF conversion and compression.

Local-First

No data ever leaves your machine. Your privacy and speed are guaranteed.

Metadata Control

Choose whether to strip or keep EXIF information (GPS, camera settings, etc.).

Usage Examples

Compress a single file with default settings.

Basic Compression
$micropng-cli input.png --output optimized.png

Optimize an entire directory maintaining structure.

Bulk Folder Processing
$micropng-cli ./assets --output ./dist --recursive

The professional way: replace originals safely.

In-Place Project Optimization
$micropng-cli ./src --recursive --replace --quality 85

Available Options

OptionAliasDescription
--output-oTarget directory or file path
--recursive-rDeep scan subfolders
--replace—Safe atomic overwrite
--quality-qCompression quality (1-100)
--format-fOutput format (webp, jpeg, avif, png)
--concurrency-cMax simultaneous tasks
--ignore-iGlob patterns to skip
--keep-metadata—Preserve EXIF/GPS data

Run micropng-cli --help for full documentation

Ready to optimize?

Install the CLI now and start optimizing your images with the same speed and privacy as the web application, but directly from your terminal.

View RepositoryNPM Package