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 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:

   osascript -e 'set the clipboard to POSIX file "<absolute output path>"'
   

   Report the path. If the clipboard copy is declined or fails, reveal the file instead: open -R <path>.

Template Library

${CLAUDE_PLUGIN_DATA}/templates/ holds the user's meme templates, synced outside git. Never copy its images into the repo. Each image may have a sidecar spec of the same basename (drake.jpg + drake.json): a ready-made layout whose text values are <slot descriptions> and whose description says how the format works.

• User names a format: ls the library and match by filename. With a sidecar, copy it to tmp/, replace each slot with the actual joke, and render with --spec. Panel counts matter: fill every slot the joke needs and drop boxes the format leaves empty.
• No sidecar (new template): Read the image, trace regions, render, iterate. Once the layout looks right, save it back as a sidecar with <slot description> placeholders so the next use skips the tracing.