Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

command line tool for creating awesome thug memes

Project description

build pypi python_versions codecov

Command line Thug Meme generator written in Python.

Installation

Requirements

  • Python 3.4+
pip3 install thug-memes

This installs the core version which supports opencv haarcascade based detector. If you are serious with your thug memes (like you definitely should), there is also support for dlib based detector which, in general, provides better results. If you want to enjoy dlib’s accuracy, please follow dlib’s own installation instructions. Some additional dlib installation guides for macOS and Ubuntu can be found in: [1] [2]. Thug memes can be installed with dlib’s Python bindings included:

pip3 install thug-memes[dlib]

Usage

thug path/to/the/original/image 'JUST CASUALLY LIFTING' '20KGs HERE'

Will store something like this in your current directory:

img1

If you have installed dlib and want to use it instead of opencv detector, add option:

--detector dlib

If you want to see the results of the detection, add –debug option:

Opencv (–debug):

img2

Dlib (–detector dlib –debug):

img3

Almost everything is configurable. You can see the used configuration with:

--show-config

The default configuration is in src/thug/defaul.conf. You can override this by defining environment variable THUG_CONF and pointing it to a file which contains overrides. In addition, you can override any of the configuration variables from command line with –override or -o options. For example:

thug path/to/original/img.jpg 'WE HAVE HUGE CIGARS' 'BUT ALSO PINK TEXT' --detector dlib -o cigar_length 2 -o glasses_width 5 -o font_bgr '[180,105,255]'

img4

For all available options, see:

thug --help

If you don’t want to have awesome Thug elements in your meme, there is also ‘a plain meme’ alternative:

meme path/to/the/original/image 'THIS IS A NORMAL MEME' 'WITHOUT THUG STUFF :(' -o font_bgr '[255,255,255]'

img5

Example images are from pexels.

Contributing

See contributing guide.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for thug-memes, version 0.1.2
Filename, size File type Python version Upload date Hashes
Filename, size thug-memes-0.1.2.tar.gz (1.2 MB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page