Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Create a static HTML/CSS image gallery from a bunch of images.

Project Description

Create a static HTML/CSS image gallery from a bunch of images.

Copyright:2007-2015 Jochen Kupperschmidt
License:MIT, see LICENSE for details.


  • Integrates ImageMagick to resize images and create thumbnails.
  • Generates clean, slim, semantically appropriate HTML5 and uses CSS 3 for styling. As a result, the output can easily be themed.
  • Provides HTML access keys for keyboard navigation.



It is recommended to create a virtual environment and run gallerize inside it.

To install ImageMagick and virtualenv on Debian/Ubuntu:

$ aptitude install imagemagick python-virtualenv

This should also give you a copy of pip.

Create a virtual environment called venv in the application path:

$ virtualenv venv

Activate it (note the space after the first dot!):

$ . venv/bin/activate

Install the dependencies of this application:

$ pip install -r requirements.txt


Run with py.test

Install pytest as test runner:

$ pip install pytest

Run tests:

$ py.test

Run with tox

To easily run tests in different Python interpreters, use tox:

$ pip install tox
$ tox

And to test against a single, specific Python interpreter (version 3.4, in this case):

$ tox -e py34


To create a gallery in the directory output from a all images in the directory images:

$ ./ output/ images/*

See the usage help for more information on specifying a gallery title, image captions, and image dimensions:

$ ./ --help
Release History

Release History

This version
History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
gallerize-0.3.2.tar.gz (2.3 kB) Copy SHA256 Checksum SHA256 Source Aug 9, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting