lazygal /

Filename Size Date modified Message
15.2 KB
95 B
2.1 KB
5.4 KB
6.2 KB


lazygal is another static web gallery generator written in Python.

It can be summed up by the following features :

  • Command line based (thus scriptable).
  • Reusable engine (to make a GUI for instance).
  • Lazy : do not build what's already there. There is still stuff to do in this area (especially regarding directory and templates modification time), but lazygal is already quite lazy.
  • Recursive : generates subgalleries.
  • Does not change your original pictures directories (the source argument).
  • Tells you what should not be in your generated directories (and delete it if you want to).
  • Can generate multiple sizes to browse pictures according to your screen.
  • Sort pictures in the same directory by EXIF date if available, else file modification time.
  • Theming.
  • XHTML and CSS compliance for provided themes.
  • Support for album meta data.

You can find more information about Lazygal at its website: <>


In addition to command line, you can specify parameters in configuration file placed as ~/.lazygal/config. This is INI like formatted file, where you can specify most of parameters same as on command line. Example:

[lazygal] theme = image-index clean-destination = Yes image-size = medium=1024x685,small=640x428 thumbnail-size = 150x100 quality = 90

Specifying album meta data

Each album can have defined some meta data such as name, description and image shown on listing (note that not all themes use all of these).

Currently only supported format is borrowed from another album generating tool - Matew. To add such metadata, create file album_description in folder where you want to add metadata. Each line is treated as one possible tag, unknown lines are simply ignored. Example content of this file follow, I hope it is self explaining:

Album name "My album" Album description "Description, which can be very long." Album image identifier relative/path/to/image.jpg

# vim: et ts=4 sw=4 sts=4 tw=72 spell spelllang=en_us