Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A Python package that allows for the dynamic alteration of images using the URL
Python JavaScript CSS Shell
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin Forgot to include the bin script for transmogrify
docs Docs building
transmogrify Version bump to 1.0.1b2
.gitignore Forgot to include the bin script for transmogrify
LICENSE Added the ability to save the file using a cropname
README.rst Only supporting Python 2.5+, so no need of the hashcompat library.
TODO.txt Cleaned up a few straw lines
USWebUncoated.icc Forgot to include the bin script for transmogrify Updated bootstrap again and again
sRGB_v4_ICC_preference.icc More auto crop stuff Added a configure script to create a settings file More auto crop stuff More auto crop stuff Made work anywhere


Transmogrify is a Python-based image manipulator. It allows for dynamic alteration of images using the URL of the image. The biggest benefit is to the web designer, as images can be scaled to fit the design on the fly.

Transmogrify is a library to dynamically alter images. Its biggest impact is probably how it frees up the designer from resizing images for different designs.

Three parts to Transmogrify


+----------------------+        +----------------------+
|      Web Server      |        |     Media Server     |
|                      |        |                      |
|    URL Generator     |        |      URL Router      |
|                      |        |   Image Processor    |
+----------------------+        +----------------------+

There are several parts to transmogrify. At the core is the image processor. It takes an image file and a set of one or more actions and outputs a new file, predictably renamed, with the actions performed. The media server can now serve this image as normal.

The URL router works with the web server when the processed file doesn't exist. It tells the image processor to create the correct version, allowing the web server to serve the file.

Lastly, the URL generator is a piece of code that generates the URL for the image based on what the designer wants to do with the image.


Currently there is a URL generator for Django (as a template tag), and URL routers for lighttpd (as a 404 handler) and Django (for local serving).

Help for other frameworks and servers is greatly appreciated. The image processor is pure python and is based on PIL.

Security Key Generation

action_string = "_r200"
sha1(action_string + SECRET_KEY).hexdigest()
Something went wrong with that request. Please try again.