memelink

name	memelink
description	Generate memes, image macros, and meme URLs from the terminal using the Memegen.link API. Use when creating memes, picking meme templates, generating funny images, or building meme URLs from text. Supports auto-generate, template-based, and custom background modes.
argument-hint	[text or template]
license	MIT
homepage	https://github.com/dedene/memelink-cli
metadata	{"author":"dedene","version":"1.1.0","openclaw":{"primaryEnv":"MEMEGEN_API_KEY","requires":{"env":["MEMEGEN_API_KEY"],"bins":["memelink"]},"install":[{"kind":"brew","tap":"dedene/tap","formula":"memelink","bins":["memelink"]},{"kind":"go","package":"github.com/dedene/memelink-cli/cmd/memelink","bins":["memelink"]}]}}

memelink CLI

Generate memes from the terminal. Wraps the Memegen.link API.

Quick Start

# Auto-generate — API picks the best template
memelink "when the code finally compiles"

# Template-based — specify template ID + text lines
memelink drake "tabs" "spaces"

# Custom background
memelink custom --background https://example.com/bg.jpg "top" "bottom"

# Copy to clipboard and open in browser
memelink drake "before memelink" "after memelink" -c -o

# JSON output for scripting
memelink --json "deploy on friday"

Commands

• memelink "text" -- auto-select template, generate meme (default command)
• memelink <template> "top" "bottom" -- generate from specific template
• memelink custom --background <url> "text" -- custom background image
• memelink templates -- list templates; interactive fuzzy picker in TTY (alias: ls)
• memelink templates <id> -- show template detail
• memelink templates --filter <query> -- filter templates
• memelink fonts -- list available fonts
• memelink config path|list|get|set|unset -- manage config
• memelink version -- print version info

Command aliases: generate → gen, g; templates → ls

Generate Flags

• --format png|jpg|gif|webp / -f -- output format
• --font <name> -- font name
• --layout default|top -- text layout
• --width N / --height N -- image dimensions
• --style <style> -- template style (repeatable)
• --text-color <hex> -- text color per line (repeatable)
• --background <url> -- custom background (with 'custom' template)
• --center x,y / --scale N -- overlay position and scale
• --safe -- filter NSFW content
• --copy / -c -- copy URL to clipboard
• --open / -o -- open in browser
• --output <path> / -O -- download image
• --preview / --no-preview -- inline terminal preview

Configuration

Config file: ~/.config/memelink/config.json

memelink config set default_format png
memelink config get default_format
memelink config list

Keys: default_format, default_font, default_layout, safe, auto_copy, auto_open, preview, cache_ttl

Environment

• MEMEGEN_API_KEY -- optional API key for higher rate limits

Global Flags

• --json -- JSON output (pipe-friendly)
• --no-input -- disable interactive prompts
• --verbose -- debug logging
• --color auto|always|never -- color output

Installation

brew install dedene/tap/memelink-cli