Skip to main content

Generates GIFs based on Tom Scott's Banhammer

Project description

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:


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.


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.


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

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

Project details

Download files

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

Source Distribution

banhammer-0.1.3.tar.gz (14.2 MB view hashes)

Uploaded source

Built Distribution

banhammer-0.1.3-py3-none-any.whl (14.2 MB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page