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`

```bash
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