derpychap / banhammer

Generates GIFs based on Tom Scott's Banhammer

Tom Scott Banhammer Generator

Generates GIFs based on Tom Scott's Banhammer

Want to use this in any project using Docker? Get the Docker container here: https://gitlab.com/nerd3-servers/banhammer-generator

Installing

Python 3.5+ is required

To install the library, simply run the following command:

pip install banhammer

If you would like to use a pillow drop-in replacement, such as pillow-simd, then install that prior to installing the banhammer. All requirements should automatically install.

Usage

banhammer.Generator() is the main generator object. To generate an image, use Generator().image_gen(str) where str is your string of choice. This will return an io.BytesIO() object, which you can then manually write to a file or upload somewhere.

Example

The following example generates a GIF and saves it to a file called output.gif:

from banhammer import Generator

# Setup the generator
g = Generator()

# Generate the GIF (returns a BytesIO object)
im = g.image_gen('Example')

# Write the image to a file called output.gif
f = open('output.gif', 'wb')
f.write(im.read())
f.close()

The resulting GIF looks something like this:

Font Licensing

The font file included is a modified version of the Bungee Regular font. The font has been modified to include missing unicode characters and emoji provided by other fonts. The licensing and source information can be found below.

Font	Designers	Licenses
Bungee Regular	David Jonathan Ross	SIL Open Font License
Twitter Color Emoji SVGinOT Font	Brad Erickson, Joe Loughry, Terence Eden, Twitter, Inc and collaborators	Massachusetts Institute of Technology License Creative Commons Attribution 4.0 International
DejaVu Sans Mono	Štěpán Roh and authors, Bitstream, Inc, Tavmjung Bah	Massachusetts Institute of Technology License
Tetsubin Gothic	フォントな自由	Apache License 2.0