image-processing

1# Image Processing
2 
3Use `img-process` (shipped in `bin/`) for common operations. For complex or custom workflows, generate a Pillow script adapted to the user's environment.
4 
5## Quick Reference — img-process CLI
6 
7```bash
8img-process resize hero.png --width 1920
9img-process convert logo.png --format webp
10img-process trim logo-raw.jpg -o logo-clean.png --padding 10
11img-process thumbnail photo.jpg --size 200
12img-process optimise hero.jpg --quality 85 --max-width 1920
13img-process og-card -o og.png --title "My App" --subtitle "Built for speed"
14img-process batch ./images --action convert --format webp -o ./optimised
15```
16 
17**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.
18 
19**Generate a custom script when**: the operation needs logic `img-process` doesn't cover (compositing multiple images, watermarks, complex text layouts, conditional processing).
20 
21## Prerequisites
22 
23Pillow is required for both `img-process` and custom scripts:
24 
25```bash
26pip install Pillow
27```
28 
29If Pillow is unavailable, use alternatives:
30 
31| Alternative | Platform | Install | Best for |
32|-------------|----------|---------|----------|
33| `sips` | macOS (built-in) | None | Resize, convert (no trim/OG) |
34| `sharp` | Node.js | `npm install sharp` | Full feature set, high performance |
35| `ffmpeg` | Cross-platform | `brew install ffmpeg` | Resize, convert |
36 
37## Output Format Guide
38…