Skip to main content

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.


2007-2015 Jochen Kupperschmidt


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

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

gallerize-0.3.2.tar.gz (2.3 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page