{"id":41219,"library":"hermione-image-minifier","title":"Hermione Image Minifier","description":"A plugin for the Hermione test runner that minifies reference images using optipng. Version 0.1.0 is the latest stable release; no release cadence documented. It integrates directly into Hermione's plugin system and offers configurable compression levels (0–7) with CLI/env overrides. Differentiator: reduces PNG reference image sizes automatically after updates.","status":"active","version":"0.1.0","language":"javascript","source_language":"en","source_url":"https://github.com/gemini-testing/hermione-image-minifier","tags":["javascript","hermione","plugin","hermione-image-minifier"],"install":[{"cmd":"npm install hermione-image-minifier","lang":"bash","label":"npm"},{"cmd":"yarn add hermione-image-minifier","lang":"bash","label":"yarn"},{"cmd":"pnpm add hermione-image-minifier","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency; plugin only works within Hermione test runner","package":"hermione","optional":false},{"reason":"binary dependency for PNG optimization","package":"optipng-bin","optional":false}],"imports":[{"note":"Plugin is configured via Hermione's plugin system; no JavaScript import needed.","wrong":"// Not imported directly; config must use full npm package name as key.","symbol":"plugin config","correct":"// In hermione config:\nplugins: { 'hermione-image-minifier': { enabled: true } }"}],"quickstart":{"code":"// hermione.config.js\nmodule.exports = {\n    system: {\n        plugins: {\n            'hermione-image-minifier': {\n                enabled: true,\n                compressionLevel: 2\n            }\n        }\n    }\n};\n// Run after updating reference images:\n// npx hermione --update-refs","lang":"javascript","description":"Configures the plugin to automatically minify reference images after they are updated, using compression level 2."},"warnings":[{"fix":"Ensure you pass --update-refs to trigger minification.","message":"Plugin only runs when reference images are updated (e.g., --update-refs). It does NOT minify on every test run.","severity":"gotcha","affected_versions":">=0.0.1"},{"fix":"If optipng-bin fails, install optipng globally (apt-get install optipng, brew install optipng) or use another image minifier plugin.","message":"optipng must be installed separately or via optipng-bin dependency; may fail on systems without native binaries.","severity":"gotcha","affected_versions":">=0.0.1"},{"fix":"Upgrade Node.js to a modern version (>=12) and verify compatibility; if plugin is unmaintained, consider forking or replacing.","message":"Requires Node.js >= 8.0.0, which is end-of-life.","severity":"deprecated","affected_versions":">=0.0.1"},{"fix":"Use lower compression levels (2-3) for faster runs if time is critical.","message":"Compression level 7 (maximum) can significantly increase processing time for large images.","severity":"gotcha","affected_versions":">=0.0.1"},{"fix":"Convert other image formats to PNG before using as reference images, or use a different minifier plugin.","message":"Plugin does not support image formats other than PNG.","severity":"gotcha","affected_versions":">=0.0.1"}],"env_vars":null,"search_vec":"'0':41 '0.1.0':18 '7':42 'automat':52 'cadenc':26 'cli/env':44 'compress':39 'configur':38 'differenti':46 'direct':30 'document':27 'hermion':1,8,32,56,59 'hermione-image-minifi':58 'imag':2,14,50,60 'integr':29 'javascript':55 'latest':21 'level':40 'minifi':3,12,61 'offer':37 'optipng':16 'overrid':45 'plugin':5,34,57 'png':48 'reduc':47 'refer':13,49 'releas':23,25 'runner':10 'size':51 'stabl':22 'system':35 'test':9 'updat':54 'use':15 'version':17","created_at":"2026-06-04T18:51:20.769287+00:00","updated_at":"2026-06-04T18:51:20.769287+00:00","problems":[{"fix":"npm install hermione-image-minifier --save-dev","cause":"Plugin not installed or not in node_modules.","error":"Error: Cannot find module 'hermione-image-minifier'"},{"fix":"Add to config: system.plugins['hermione-image-minifier'] = { enabled: true }","cause":"Plugin not listed in system.plugins in hermione config.","error":"Plugin 'hermione-image-minifier' not found in plugins"},{"fix":"Install optipng system-wide: apt-get install optipng (Linux) or brew install optipng (macOS)","cause":"optipng binary missing or broken.","error":"Error: optipng failed with exit code 1"}],"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/gemini-testing/hermione-image-minifier#readme","github":"https://github.com/gemini-testing/hermione-image-minifier","docs":null,"changelog":null,"pypi":null,"npm":"hermione-image-minifier","openapi_spec":null,"status_page":null,"smithery":null,"categories":["testing"],"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}}