Skip to content

A command line utility for creating memes

License

Notifications You must be signed in to change notification settings

nomad-software/meme

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ff7c3fc · Sep 26, 2023

History

71 Commits
Apr 17, 2021
Jan 30, 2021
Jan 30, 2021
Apr 17, 2021
Oct 7, 2018
Sep 26, 2023
Dec 21, 2016
Apr 17, 2021
Jan 25, 2017
Sep 26, 2023
Sep 26, 2023
Apr 17, 2021

Repository files navigation

Meme

A command line utility for creating image macro style memes

Go report card

Requires Go v1.16+ to compile.


Am i the only one around here?

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 get -u -v github.com/nomad-software/meme

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"

Brace yourselves


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

When somebody mentions china


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

khaaaaan


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

triggered


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.)