Skip to main content

simple static gallery generator

Project description

sigal is yet another python script to build a static gallery of images:

  • process directories recursively,
  • resize images and create thumbnails,
  • generate html pages using jinja2 templates and with relative links for a portable output.


  • Python Imaging Library (PIL)
  • Jinja2
  • pyexiv2 (optionnal, used to copy exif metadatas)


$ sigal [-h] [--version] [-c COPYRIGHT] [-f] input_dir output_dir

Required arguments:

input_dir input directory
output_dir output directory

Optional arguments

-h|--help show this help message and exit
--version show program’s version number and exit
-c|--copyright COPYRIGHT copyright message added to the images
-f|--force force the reprocessing of existing images and thumbnails


Options can be set globally in ~/.config/sigal/sigal.conf and in the source directory input_dir/sigal.conf.

# theme
theme = default
# size of resized image
img_size = 640x480
# prefix for thumbnails name
thumb_prefix = TN-
# thumbnail size
thumb_size = 150x112
# keep big image
big_img = 1
bigimg_dir = original
# generate squared thumbnails
square_thumb = 1
# jpeg quality
jpg_quality = 90
# keep exif metadatas in output image
exif = 1
# add a copyright text on the image
copyright = the copyright msg

Album information

Information on an album can be given in a file named album_description (else the directory’s name is used)

album_name = "An example gallery"
album_description = "And a cool description."
album_representative = "test1.jpg"


sigal use or is inspired from some code from other projects:

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
sigal-0.1.tar.gz (99.2 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page