{"id":41287,"library":"images-minifier","title":"images-minifier","description":"CLI tool to compress image folders or convert them to WebP. Current version 2.1.0, updated sporadically. Copies an input directory, then compresses or converts images to WebP, leaving originals untouched. Supports beautifying output directory structure. Works on whole folders at once, requires Node >=18. Differentiator: simple CLI for batch folder processing, no extra WebP package needed after install.","status":"active","version":"2.1.0","language":"javascript","source_language":"en","source_url":"https://github.com/zhuylanz/images-minifier","tags":["javascript","images","image","minify","compress","webp","cli"],"install":[{"cmd":"npm install images-minifier","lang":"bash","label":"npm"},{"cmd":"yarn add images-minifier","lang":"bash","label":"yarn"},{"cmd":"pnpm add images-minifier","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"image processing (compress, convert to webp)","package":"sharp","optional":false},{"reason":"filesystem operations (copy, ensure directory)","package":"fs-extra","optional":false},{"reason":"CLI argument parsing","package":"yargs","optional":false}],"imports":[{"note":"Named export; default import is undefined.","wrong":"import minifyImages from 'images-minifier'","symbol":"minifyImages","correct":"import { minifyImages } from 'images-minifier'"},{"note":"Direct destructure works.","wrong":"const imagesMinifier = require('images-minifier'); imagesMinifier.minifyImages()","symbol":"minifyImages (CommonJS)","correct":"const { minifyImages } = require('images-minifier')"},{"note":"The CLI binary is called 'imini', not the package name.","wrong":"images-minifier <input_dir> <output_dir>","symbol":"CLI usage","correct":"imini <input_dir> <output_dir>"}],"quickstart":{"code":"// Install globally\nnpm install -g images-minifier\n\n// Compress a folder (CLI)\nimini ./images ./compressed-images\n\n// Convert to WebP (CLI)\nimini --use-webp ./images ./webp-images\n\n// Programmatic usage\nimport { minifyImages } from 'images-minifier';\n\nawait minifyImages('./images', { webp: true, beautifyDir: true });\nconsole.log('Done');","lang":"typescript","description":"Install globally, then compress or convert folders via CLI or programmatic API with minifyImages."},"warnings":[{"fix":"Use named import: const { minifyImages } = require('images-minifier')","message":"Version 2.x removed the old default export; now only named export minifyImages is available.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Run command as: imini <input> <output>","message":"CLI binary is named 'imini', not 'images-minifier' or 'imagemin'.","severity":"gotcha","affected_versions":"all"},{"fix":"Test with small folder first; consider manual folder rearrangement.","message":"The --beautify-dir option may produce unexpected folder structures if input has deeply nested folders.","severity":"deprecated","affected_versions":"all"},{"fix":"Ensure output disk space is at least double the input size.","message":"The tool copies the input directory first, so output directory must have enough free space for duplicate.","severity":"gotcha","affected_versions":"all"},{"fix":"Upgrade Node to v18 or later.","message":"Node.js >=18 required; older versions will fail to install or run.","severity":"breaking","affected_versions":">=2.0.0"}],"env_vars":null,"search_vec":"'18':47 '2.1.0':17 'batch':52 'beautifi':35 'cli':4,50,68 'compress':7,25,66 'convert':11,27 'copi':20 'current':15 'differenti':48 'directori':23,37 'extra':56 'folder':9,42,53 'imag':2,8,28,63,64 'images-minifi':1 'input':22 'instal':61 'javascript':62 'leav':31 'minifi':3,65 'need':59 'node':46 'origin':32 'output':36 'packag':58 'process':54 'requir':45 'simpl':49 'sporad':19 'structur':38 'support':34 'tool':5 'untouch':33 'updat':18 'version':16 'webp':14,30,57,67 'whole':41 'work':39","created_at":"2026-06-04T18:51:40.920370+00:00","updated_at":"2026-06-04T18:51:40.920370+00:00","problems":[{"fix":"Run 'npm install sharp' or reinstall images-minifier with 'npm install -g images-minifier --build-from-source'","cause":"sharp native module failed to install or is missing.","error":"Error: Cannot find module 'sharp'"},{"fix":"Install globally: 'npm install -g images-minifier'","cause":"Package not installed globally or PATH not set.","error":"imini: command not found"},{"fix":"Use: const { minifyImages } = require('images-minifier')","cause":"Using wrong import pattern: importing default instead of named export.","error":"TypeError: imagesMinifier.minifyImages is not a function"},{"fix":"Check the input path and ensure it exists: ls <input_dir>","cause":"Specified input path is wrong or missing.","error":"Error: Input directory does not exist"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/zhuylanz/images-minifier#readme","github":"https://github.com/zhuylanz/images-minifier","docs":null,"changelog":null,"pypi":null,"npm":"images-minifier","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-04","next_check":"2026-09-02","install_tag":null}}