image-processinglisted

# Image Processing Use `img-process` (shipped in `bin/`) for common operations. For complex or custom workflows, generate a Pillow script adapted to the user's environment. ## Quick Reference — img-process CLI ```bash img-process resize hero.png --width 1920 img-process convert logo.png --format webp img-process trim logo-raw.jpg -o logo-clean.png --padding 10 img-process thumbnail photo.jpg --size 200 img-process optimise hero.jpg --quality 85 --max-width 1920 img-process og-card -o og.png --title "My App" --subtitle "Built for speed" img-process batch ./images --action convert --format webp -o ./optimised ``` **Use `img-process` when**: the operation is standard (resize, convert, trim, thumbnail, optimise, OG card, batch). This is faster and avoids generating a script each time. **Generate a custom script when**: the operation needs logic `img-process` doesn't cover (compositing multiple images, watermarks, complex text layouts, conditional processing). ## Prerequisites Pillow is required for both `img-process` and custom scripts: ```bash pip install Pillow ``` If Pillow is unavailable, use alternatives: | Alternative | Platform | Install | Best for | |-------------|----------|---------|----------| | `sips` | macOS (built-in) | None | Resize, convert (no trim/OG) | | `sharp` | Node.js | `npm install sharp` | Full feature set, high performance | | `ffmpeg` | Cross-platform | `brew install ffmpeg` | Resize, convert | ## Output Format Guide | Use case | Format | Wh