meme

README

Meme

A command line utility for creating image macro style memes

Requires Go v1.16+ to compile.

---

Features

• Create memes from built-in templates
• Create memes from image URL's
• Create memes from local image files
• Supports drawing on animated gifs
• Supports intensifing images by shaking them slightly
• Supports adding the 'triggered' banner
• Resizes oversized images
• Automatically upload to imgur.com (when passed a client id)
• Works on Linux, Mac and Windows

Simple example

To create a meme use the following command. The image can be an built-in template, a URL or the path to a local file.

meme -i brace-yourselves -t "brace yourselves|the memes are coming"

When the command finishes, the location of the newly generated meme is printed to the terminal. This location can be overriden using the -o flag.

Installation

• Install Go
• Run go install github.com/PontusTideman/meme@latest
• Open up .zshrc or create a new one if you don´t have one.
• Add export GOPATH="$HOME/go" export PATH=$PATH:$GOPATH/bin
• Run source ~/.zshrc in terminal after.

Automatic uploads

If you supply an imgur client id when invoking the command, the meme will automatically be uploaded to imgur.com. To get a client id, follow these steps.

1. Create an imgur account
2. Register this application for anonymous usage
3. Once registered, you get a client id for use when invoking the command. See meme -help
4. Read the rate limits

Help

Run the following command for help and to list all of the available built-in templates.

meme -help

Other examples

meme -i brace-yourselves -t "brace yourselves|the memes are coming"

---

meme -gif -i http://www.reactiongifs.com/r/trmp.gif -t "|when somebody mentions china"

---

meme -shake -i kirk-khan -t "|khaaaaan"

---

meme -trigger -i https://i.giphy.com/3o7abKGM3Xa70I7jCU.gif

---

Built-in templates

To create a meme using one of the built-in templates, use one of the following id's with the -i flag. (You can also list these using the meme -help command.)

• advice-mallard
• all-the-things
• am-i-the-only-one
• ancient-aliens
• archer-do-you-want
• awkward-sealion
• baby-insanity-wolf
• back-in-my-day
• bad-guy-boss
• bad-luck-brian
• brace-yourselves
• college-liberal
• condescending-wonka
• confession-bear
• confession-kid
• dicaprio-cheers
• disaster-girl
• doge
• dr-evil-lasers
• everywhere
• first-world-problems
• fuck-me-right
• futurama-fry
• good-guy-boss
• good-guy-greg
• grumpy-cat
• high-guy
• how-do-they-work
• i-should-buy-a-boat-cat
• kirk-khan
• laughing-men-in-suits
• look-at-me
• minor-mistake-marvin
• mocking-spongebob
• morpheus
• most-interesting-man
• none-of-my-business
• one-does-not-simply
• oprah-you-get-a
• overly-attached-girlfriend
• pepperidge-farm-remembers
• peter-griffin-news
• philosoraptor
• picard-facepalm
• picard-wtf
• politically-correct-redneck
• satisfied-seal
• scumbag-stacy
• scumbag-steve
• so-hot-right-now
• so-i-got-that-goin-for-me
• success-kid
• sudden-clarity-clarence
• that-would-be-great
• third-world-skeptical-kid
• too-damn-high
• unhelpful-highschool-teacher
• unpopular-opinion-puffin
• waiting-skeleton
• y-u-no
• yall-got-any-more-of