DerpyChap / banhammer

Generates GIFs based on Tom Scott's Banhammer

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

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

About

Generates GIFs based on Tom Scott's Banhammer

License:ISC License


Languages

Language:Python 100.0%