image

# Meme Image Overlay meme text on an image with a deterministic renderer. You judge layout, placement, and legibility; the script guarantees the classic look (Impact stroke, subtitle yellow, caption bars). ## Workflow 1. Resolve the image. Use the user's path directly. If they name a meme format instead of a path, check the template library first (below). Otherwise WebSearch for the image and download with `curl -L -o tmp/<name>.jpg <url>`. Never pass a URL to the renderer. 2. Read the image. Note the subjects, where faces and action are, contrast, and aspect ratio. 3. Choose a mode: - Top/bottom macro text: `--top` / `--bottom` - TV-subtitle quote (yellow, bottom center): `--subtitle` - White bar above or below the image: `--caption` (optionally `--caption-position top|bottom`, default top) - Multi-label formats or custom placement: write a JSON spec file. Read [references/spec.md](references/spec.md) first. 4. Pick the output filename. It is part of the joke: witty and meme-relevant, kebab or snake case, `.png`. Never `meme.png` or another generic name. If the user supplies a filename, use theirs. 5. Render, then Read the output PNG. Check legibility, that text does not cover key subjects, line-break placement, and any fit warnings on stderr. Adjust and re-render until it reads well. 6. Deliver: copy the file reference to the clipboard so a paste keeps the filename: ```sh osascript -e 'set the clipboard to POSIX file "<absolute output path>"' ``` ...