Generating Memes

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:

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

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

Meme Generation Examples

Practical examples for creating memes with various templates.

Table of Contents

• Basic Examples
• Text-Only Memes
• Image-Based Memes
• Advanced Usage
• Common Workflows

---

Basic Examples

Petpet Meme (Most Popular)

The petpet template creates a petting animation.

# Using a local image
meme generate petpet --images avatar.jpg

# Save to file
meme generate petpet --images avatar.jpg > petpet.gif

# With circular crop
meme generate petpet --images avatar.jpg --circle > petpet_circle.gif

Requirements: 1 image, 0 text Optional: --circle flag for circular image

---

Slap Meme

Creates a slapping animation.

meme generate slap --images target.jpg > slap.gif

Requirements: 1 image, 0 text

---

Hug Meme

Creates a hugging animation.

meme generate hug --images friend.jpg > hug.gif

Requirements: 1 image, 0 text

---

Rub/Nuzzle Meme

Creates a nuzzling animation.

meme generate rub --images person.jpg > rub.gif

Requirements: 1 image, 0 text

---

Text-Only Memes

5000兆 (Big/Small Contrast)

Creates a big/small text contrast meme.

meme generate 5000choyen --texts "IMPORTANT" "ignore this"

Requirements: 0 images, 2 text (big, small)

Example output:

IMPORTANT
    ignore this

---

Always Meme

Creates an "always" format meme.

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

Requirements: 0 images, 1 text

---

YouTube Style

Creates a YouTube-style thumbnail.

meme generate youtube --texts "Video Title" "Channel Name"

Requirements: 0 images, 2 text

---

Good News Header

Creates a "good news" header.

meme generate good_news --texts "Project completed!"

Requirements: 0 images, 1 text

---

Bad News Header

Creates a "bad news" header.

meme generate bad_news --emails "Deployment failed"

Requirements: 0 images, 1 text

---

Shock Meme

Creates a shocked reaction.

meme generate shock --texts "What?!"

Requirements: 0 images, 1 text

---

Image-Based Memes

Petpet (Multiple Variants)

# Standard petpet
meme generate petpet --images photo.jpg

# Circular crop
meme generate petpet --images photo.jpg --circle

# With custom output name
meme generate petpet --images photo.jpg > my_petpet.gif

---

Slap

meme generate slap --images target.jpg

---

Pat

meme generate pat --images head.jpg

---

Pinch

meme generate pinch --images face.jpg

---

Kiss

meme generate kiss --images partner.jpg

---

Hug

meme generate hug --images friend.jpg

---

Stare

meme generate stare_at_you --images person.jpg

---

Advanced Usage

Batch Processing

Generate multiple memes at once:

# Create petpet variants for all images
for img in *.jpg; do
    meme generate petpet --images "$img" > "petpet_$(basename $img .jpg).gif"
done

# Create slap variants
for img in faces/*.jpg; do
    meme generate slap --images "$img" > "slap_$(basename $img .jpg).gif"
done

---

Custom Parameters (Abstinence Example)

Some templates have optional parameters:

# Check available parameters
meme info abstinence

# Generate with time parameter
meme generate abstinence --images user.jpg --time "30d"

---

Multiple Images

Some templates accept multiple images:

# Check template requirements first
meme info <template>

# Generate with multiple images (if supported)
meme generate <template> --images img1.jpg img2.jpg img3.jpg

---

Text + Image Templates

Templates that accept both images and text:

# Check requirements
meme info high_eq

# Generate with both
meme generate high_eq --images reaction.jpg --texts "Low EQ" "High EQ description"

---

Common Workflows

Workflow 1: Discovery -> Preview -> Generate

When you don't know which template to use:

# 1. Search for templates by keyword
meme search "pet"

# 2. Preview the template to see what it looks like
meme preview petpet

# 3. Check requirements
meme info petpet

# 4. Generate the meme
meme generate petpet --images photo.jpg > output.gif

---

Workflow 2: List -> Filter -> Generate

When browsing all templates:

# 1. List all templates and filter
meme list | grep -i "hug"

# 2. Get detailed info
meme info hug

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

---

Workflow 3: Quick Generate (Known Template)

When you already know the template:

# Generate directly
meme generate petpet --images photo.jpg > petpet.gif

---

Workflow 4: Text Meme Generation

For text-based memes:

# 1. Find a text template
meme search "text"

# 2. Check if it needs images
meme info 5000choyen

# 3. Generate with text
meme generate 5000choyen --texts "BIG" "small"

---

Template-Specific Examples

Anime/Game Characters

# Anya likes
meme generate anya_suki --images photo.jpg

# Genshin eating
meme generate genshin_eat --images character.jpg

# Lu Xun quote
meme generate luxun_say --texts "鲁迅说过"

---

Reactions/Emotions

# Applause
meme generate applaud --images clapping.jpg

# Shocked
meme generate shock --texts "震惊!"

# Speechless
meme generate speechless --images expression.jpg

# Clown
meme generate clown --images face.jpg

---

Visual Effects

# Pixelate
meme generate pixelate --images photo.jpg

# 3D Rotate
meme generate rotate_3d --images object.jpg

# Symmetric
meme generate symmetric --images face.jpg

# Kaleidoscope
meme generate kaleidoscope --images pattern.jpg

---

Tips and Tricks

Saving Output

Always redirect output to save the file:

# Good - saves to file
meme generate petpet --images photo.jpg > output.gif

# Bad - outputs to terminal (binary garbage)
meme generate petpet --images photo.jpg

---

Checking Requirements First

Always check template info before generating:

# See what the template needs
meme info <template>

# This tells you:
# - How many images are required
# - How many text arguments are needed
# - What optional parameters are available

---

Using Preview

Preview templates before committing:

# Generate a preview to see the template structure
meme preview petpet

---

Downloading Resources

If templates are missing resources:

# Download all required assets
meme download

---

Troubleshooting Examples

Template Not Found

# Verify template exists
meme list | grep petpet

# Search for similar templates
meme search "pet"

# Case matters - use lowercase
meme generate PetPet --images photo.jpg  # Wrong
meme generate petpet --images photo.jpg  # Correct

---

Missing Images

# Verify image exists
ls -la photo.jpg

# Use absolute path if needed
meme generate petpet --images /full/path/to/photo.jpg

---

Network Issues (Download Failed)

If meme download fails:

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

# Solution: Try generating directly - some templates work offline
meme generate petpet --images photo.jpg > test.gif

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

Note: Some templates have built-in assets and work without downloading resources.

---

Output Format

Generated memes are typically in GIF format for animations and PNG for static images.

Meme Templates Reference

Complete list of 298 meme templates organized by category.

Contents

• Action/Animation
• Character/Anime
• Emotion/Reaction
• Game/Media
• Text/Quote
• Utility/Tools

Search Tips

Use grep to find templates:

grep -i "pet" references/templates.md
grep -i "hug" references/templates.md

Or use the CLI search:

meme search <keyword>

---

Action/Animation

Physical actions and animations.

Hand/Touch Actions

Holding/Lifting

Throwing/ Dropping

Movement

Other Actions

---

Character/Anime

Anime, game, and character-based templates.

Anime Characters

Game Characters (Genshin)

Game Characters (Other)

Capoo Series

---

Emotion/Reaction

Emotional reactions and expressions.

Positive

Negative

Shock/Surprise

Neutral/Subtle

---

Game/Media

Game, anime, and media references.

Games

Social Media/Platforms

Movies/TV

---

Text/Quote

Text-based memes and quotes.

Text Styles

Quote/Speech

Statements

---

Utility/Tools

Utility and tool-based templates.

Documents/Certificates

Status/Loading

Visual Effects

Other Utilities

---

Full Alphabetical List

For quick reference, all templates alphabetically:

5000choyen, abstinence, ace_attorney_dialog, acg_entrance, add_chaos,
addiction, alike, alipay, always, always_like, anti_kidnap, anya_suki,
applaud, arona_throw, ascension, ask, atri_pillow, ayachi_holdsign,
ba_say, back_to_work, backflip, bad_news, batitle, beat_head, beat_up,
blamed_mahiro, blood_pressure, bocchi_draft, bronya_holdsign, bubble_tea,
call_110, capoo_draw, capoo_point, capoo_rip, capoo_rub, capoo_say,
capoo_stew, capoo_strike, captain, caused_by_this, certificate, chanshenzi,
charpic, chase_train, china_flag, chino_throw, clauvio_twist, clown,
clown_mask, confuse, coupon, cover_face, crawl, cyan, daynight, decent_kiss,
dianzhongdian, dinosaur, distracted, divorce, dog_dislike, dog_of_vtb,
dont_go_near, dont_press, dont_touch, doraemon_say, douyin, eat,
emperor_dragon, erised_mirror, fade_away, fanatic, father_work, fencing,
fight_with_sunuo, fill_head, find_chips, firefly_holdsign, flash_blind,
flick, flush, fogging, follow, forbid, frieren_take, funny_mirror, garbage,
genshin_eat, genshin_start, good_news, google, google_captcha, gorilla_throw,
grab, grab_both_hands, guichu, gun, hammer, haruhi_raise, head_butt,
high_eq, hit_screen, hold_grudge, hold_tight, hug, hug_leg, hutao_bite,
imprison, incivilization, intel_inside, interview, jerry_stare, jiamianqishi,
jiji_king, jinhsi, jiubingfufa, jiujiu, jump, kaleidoscope, karyl_point,
keep_away, keep_your_money, kick_ball, kirby_hammer, kiss, klee_eat, knock,
kokona_seal, konata_watch, learn, left_right_jump, let_me_in, lick_candy,
lim_x_0, listen_music, little_angel, loading, look_flat, look_this_icon,
loop, lost_dog, love_you, luotianyi_need, luotianyi_say, luoyonghao_say,
luxun_say, mahiro_readbook, maikease, maimai_awaken, maimai_join, make_friend,
marriage, meteor, mihoyo, mourning, murmur, my_friend_say, my_opinion, my_wife,
nahida_bite, name_generator, need, nekoha_holdsign, nihaosaoa, nijika_holdsign,
no_response, nokia, note_for_leave, operator_generator, oshi_no_ko, osu, out,
overtime, p5letter, paint, painter, panda_dragon_figure, pass_the_buck, pat,
pepe_raise, perfect, petpet, pinch, pixelate, pjsk, plana_eat, play_baseball,
play_basketball, play_game, play_together, police, policeman, pornhub, potato,
pound, praise, printing, prpr, psyduck, punch, pyramid, qiegewala, raise_image,
raise_sign, read_book, remote_control, repeat, rip, rip_angrily, rip_clothes,
rise_dead, roll, rotate_3d, rub, run, run_away, safe_sense, saimin_app,
scratch_head, scratchcard, scroll, seal, sekaiichi_kawaii, shake_head,
shiroko_pero, shishilani, shock, shuifandui, shutup, sit_still, slap, slogan,
smash, sold_out, speechless, sphere_rotate, spider, stare_at_you, steam_message,
step_on, stew, stickman_dancing, subject3, suck, support, swirl_turn, symmetric,
tankunku_raisesign, taunt, teach, tease, telescope, thermometer_gun, think_what,
this_chicken, throw, throw_gif, thump, thump_wildly, tightly, time_to_go, together,
tom_tease, tomb_yeah, trance, trolley, turn, twist, universal, upside_down,
vibrate, wakeup, wallpaper, walnut_pad, walnut_zoom, wangjingze, washer, wave,
wechat_pay, weisuoyuwei, what_he_wants, what_i_want_to_do, why_at_me,
why_have_hands, windmill_turn, wish_fail, wooden_fish, worship, wujing, wunian,
wuyage, yalidaye, yeshu, you_dont_get, you_should_call, your_new_years_eve,
youtube, zengxiaoxian