Skip to main content

CHArming GALLery in PYthon

Project description


(Cha)rming (gall)ery in (Py)thon is a static, minimalistic and mostly JS-free web gallery generator. In a way, it serves as an example project for the WOWP framework (see

The gallery does not depend on any external JS library and is navigable using standard (whatever reasonable definition of "standard") keyboard shortcuts.


Just run this command in the directory with photos:

Usage: chagall [OPTIONS]

  -i, --input TEXT  (default .)
  -o, --output TEXT  (default ./build)
  -S, --image-size INTEGER
  -T, --thumbnail-size INTEGER
  -v, --verbose

It finds all JPEG images in a current directory, then tries to read metadata about them and produces a gallery in output directory.

Example galleries produced with chagallpy:


Easiest way is to use "pip" and download the package from PyPI.

pip install chagallpy

Or, you can visit the GitHub page of the project and work with the development version:


Gallery metadata

Metadata are store in gallery.yaml. Currently available configuration options:

  • title

Image metadata

Available EXIF data are read.

For each image.jpg, a file image.yaml is read with the following options:

  • title
  • place
  • date (dd/mm/YYYY)
  • author (additional (c) is displayed in the image toolbar)

Project details

Download files

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

Files for chagallpy, version 0.1.5
Filename, size File type Python version Upload date Hashes
Filename, size chagallpy-0.1.5.tar.gz (12.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page