iconforger

A zero-setup Node.js CLI that turns a single 1024×1024 icons/app.png (plus optional tray variants) into production-ready assets for Windows, macOS, and Linux.

Installation

npm install iconforger

Quick Start

npx iconforge [options]

Options:

• --pad <percent> — add transparent padding (default 10, max 40).
• --watch — rebuild automatically whenever files in icons/ change.

Project Layout

project/
 ├─ icons/
 │   ├─ app.png          # required, 1024×1024
 │   ├─ tray_light.png   # optional
 │   └─ tray_dark.png    # optional
 └─ dist/icons/          # generated output

Output Files

• icon.png (512×512) for Linux/Electron launchers.
• icon.ico (multi-size) for Windows.
• icon.icns generated via png2icons so it works off macOS.
• tray_light_{16,22,24,32}.png and tray_dark_{…}.png for system trays.

Local Development

npm install
npm run build    # single build
npm run watch    # watch mode

License

MIT