Generating Memes

Creates memes using the meme CLI tool with 298+ templates.

Quick Start

List all templates:

meme list

Search templates by keyword:

meme search <keyword>

Generate a meme:

meme generate <template> --images <paths> --texts <texts>

Popular Templates

Most commonly used templates:

Template	Description	Type
petpet	Petting animation (摸/摸摸)	Image
slap	Slapping animation (一巴掌)	Image
hug	Hugging animation (抱/抱抱)	Image
rub	Nuzzling animation (贴/贴贴)	Image
pat	Patting animation (拍)	Image
kiss	Kissing animation (亲/亲亲)	Image
pinch	Pinching face (捏/捏脸)	Image
5000choyen	Big/small text contrast	Text
always	"Always" format meme	Text
shock	Shocked reaction (震惊)	Text
clown	Clown meme (小丑)	Image
stare_at_you	Staring at you (盯着你)	Image
loading	Loading animation	Text
good_news	Good news header (喜报)	Text
bad_news	Bad news header (悲报)	Text
applaud	Applause (鼓掌)	Image
praise	Praise (表扬)	Text
speechless	Speechless (无语)	Image
run_away	Run away (快逃)	Image
suck	Suck/Sip animation (吸/嗦)	Image

See full template list

Usage Patterns

Image-based Memes

Templates requiring one or more images:

# Single image
meme generate petpet --images /path/to/photo.jpg

# Save to file
meme generate petpet --images /path/to/photo.jpg > output.gif

Text-based Memes

Templates using only text:

# 5000兆 (big/small contrast)
meme generate 5000choyen --texts "IMPORTANT" "ignore this"

# Always meme
meme generate always --texts "the answer is 42"

Mixed (Images + Text)

Recommended Workflow

1. Search for a template: meme search <keyword>
2. Preview the template: meme preview <template>
3. Check requirements: meme info <template>
4. Generate the meme: meme generate <template> [options]

Example: Create a Petpet Meme

# 1. Verify template exists
meme search pet

# 2. See what it needs
meme info petpet
# Output: needs 1 image, 0 text

# 3. Generate
meme generate petpet --images friend.jpg > petpet.gif

Commands Reference

Command	Description
meme list	List all 298 templates
meme search <keyword>	Search templates by keyword
meme info <template>	Show template requirements (images, texts, params)
meme preview <template>	Generate template preview
meme generate <template>	Create meme
meme download	Download required resources

See more examples

Troubleshooting

"meme: command not found"

The meme CLI is not installed. Install it from GitHub:

# Download the binary
curl -L https://github.com/MemeCrafters/meme-generator-rs/releases/latest/download/meme-x86_64-unknown-linux-gnu -o meme

# Make executable and install
chmod +x meme
sudo mv meme /usr/local/bin/

# Download required resources
meme download

GitHub: https://github.com/MemeCrafters/meme-generator-rs

Alternative: Build from source with Rust:

cargo install meme-generator
meme download

Template Not Found

If generation fails with "unknown template" error:

# Verify template name
meme list | grep <template>

# Search for similar templates
meme search <keyword>

# Check template info
meme info <template>

Missing Resources

If images or templates are missing:

meme download

This downloads all required template assets.

Network Issues (Download Failed)

If meme download fails with connection timeout:

# Error example:
# WARN Failed to download: Connection timed out (os error 110)
# The CLI cannot reach cdn.jsdelivr.net

# Solution: Download resources manually from GitHub releases
# Visit: https://github.com/MemeCrafters/meme-generator-rs/releases

Note: Some templates may work without downloaded resources if they have built-in assets.

Tips

• Use meme info <template> before generating to understand requirements
• Redirect output to save: > output.gif
• Many templates support both images and text
• Some templates have optional parameters (like --circle for petpet)
• Use meme search for discovery when unsure of template name