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.

Source Distribution

chagallpy-0.1.5.tar.gz (12.3 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