SuperImg

Node.js + Sharp image compression tool with both CLI and Web UI modes.

Features

• Shared Sharp core for CLI and Web processing.
• CLI supports one image or a whole folder.
• CLI recursively scans folders and keeps nested output paths.
• Quality compression, output format conversion, output directory selection.
• Preserve original output format when no target format is selected.
• Resize by width, height, or both.
• Preserve aspect ratio by default.
• Web UI supports drag-and-drop upload, folder upload, preview, quality/format/size controls, and result download.
• Web UI supports PNG/JPG compression and conversion to WebP.
• Web UI can preserve each image's original format instead of forcing one output format.
• Folder uploads are returned as a ZIP that preserves the original directory structure, with -compress added to the top-level folder name.

Install

npm install

Web UI

npm start

Open:

http://localhost:3000

For a folder named photos, Web processing returns:

photos-compress.zip
└── photos-compress/
    ├── image-a.webp
    └── nested/
        └── image-b.webp

CLI

Process a single image:

node src/cli.js -i ./photo.png -o ./dist -f webp -q 80 --width 1200

Process a folder recursively:

node src/cli.js -i ./images -o ./dist -f webp -q 75 --width 1600

Resize without preserving the original aspect ratio:

node src/cli.js -i ./images -o ./dist -f jpeg -q 82 --width 800 --height 600 --no-keep-aspect

CLI Options

-i, --input <path>      image file or image folder path
-o, --output <dir>      output directory; omit to replace input files in place
-q, --quality <number>  compression quality, 1-100
-f, --format <format>   jpeg, png, webp
--width <px>            resize width
--height <px>           resize height
--no-keep-aspect        force exact width/height

Project Structure

src/core/config.js      shared parameter normalization and format helpers
src/core/processor.js   shared Sharp processing logic
src/cli.js              command-line entry
src/server.js           Express server and image API
public/                 Web UI
scripts/smoke-test.js   basic end-to-end processing test