optimo

optimo aggressively reduces image size with format-specific ImageMagick presets.

Prerequisites

ImageMagick must be installed and available as magick. If magick is missing, optimo throws: ImageMagick is not installed.

Quick Start (CLI)

Use npx for one-off runs:

npx -y optimo public/media

Optimize a single file:

npx -y optimo public/media/banner.png

Run a dry run (no file changes):

npx -y optimo public/media/banner.png --dry-run

Convert and optimize to a new format:

npx -y optimo public/media/banner.png --format jpeg

Recommended Workflow

1. •Start with --dry-run to confirm target files.
2. •Run optimization on a file first, then on directories.
3. •Use --format only when conversion is intended.
4. •Verify outputs in version control before committing.

CLI Options

• •-d, --dry-run: Show what would change without writing files.
• •-f, --format: Convert output format (jpeg, webp, avif, etc.).
• •-s, --silent: Suppress per-file logs.

Programmatic API

const optimo = require('optimo')

await optimo.file('/absolute/path/image.jpg', {
  dryRun: false,
  format: 'webp',
  onLogs: console.log
})

const result = await optimo.dir('/absolute/path/images')
console.log(result)
// { originalSize, optimizedSize, savings }

Behavior Notes

• •For non-conversion runs, if the optimized file is not smaller, the original file is kept.
• •During conversion, output uses the new extension and the original source file is removed (unless --dry-run).
• •Hidden files and folders (names starting with .) are skipped in directory mode.
• •Unsupported files are reported as [unsupported] and ignored.