Skip to main content

Placeholder image on the fly for Turbogears2

Project description






About tgapp-placeholder

tgapp-placeholder is a Pluggable application for TurboGears2 that allows placeholder images generation on the fly. Inspired by and


placeholder can be installed both from pypi or from github:

pip install tgapp-placeholder

should just work for most of the users

Plugging placeholder

In your application config/ import plug:

from tgext.pluggable import plug

Then at the end of the file call plug with placeholder:

plug(base_config, 'placeholder')

You will be able to access the plugged application at http://localhost:8080/placeholder.

Using placeholder

You are now able to get your fake images by calling:

http://you-application/placeholder/{width} #for a square image
http://you-application/placeholder/{width}x{height}?text={some text value}
actually the parameters you can play with are:
  • text : a custom online text wich size is calculated to fit your image width

  • bgcolor : the background color in HEX rgb form (default set to ‘DDDDDD’)

  • color : the text color in HEX rgb form (default set to ‘888888’)

  • format : available formats available here (default set to PNG)

  • font_size : font_size of the eventtual text. If none is provided it is automagically calculated to fit the whole text in the image width.


Your movie stars by placeholder! Now you can generate custom-size placeholder images of Bill Murray, Steven Seagal and the greatest artist of all times Nicolas Cage!

Just add the name of you movie hero in the URL, like:

http://you-application/placeholder/stevenseagal/{width} #for a square image

No text, bgcolor, color, format or font size needed! Just the name of an hero, and see the magic!

EXTRA: Nicolas Cage

Nicolas The Great Cage images supports the gray or the gif mode. Just add the mode in your URL:

Available modes:
  • g : gray mode

  • gif: gif mode

  • c: Wanna see some crazy stuff? Try the crazy Cage mode!

Based on famous placeholder generator by Dave Cowart (,,

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

tgapp-placeholder-1.0.1.tar.gz (27.8 kB view hashes)

Uploaded Source

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