lazygal — static web gallery generator
-h | -v |
This manual page explains the lazygal program. This program is a static web gallery generator written in Python.
lazygal works so: you should have an original store of files - possibly containg subdirectories (their names serving as headings if not using the album metadata feature). This is the source file hierarchy. It will never be modified by lazygal. Then, when launching:
$ lazygal -o /var/www/MyAlbum
lazygal will analyze the contents of the source hierarchy and will (re)create the target hierarchy, but with all the bells and whistles defined by the templates. Only missing parts or parts that are not up to date will be generated. There is a limitation to this mechanism though: although updates in the source directory, in the metadata or in the themes is detected, changes in command line options and configuration files since last generation are not and the user should manually delete files that need to be generated again.
These programs follow the usual GNU command line syntax,
with long options starting with two dashes (`-'). A summary of
options is included below. For a complete description, see the
Show program's version number and exit.
Show summary of options.
Don't output anything except for errors.
Output everything that lazygal is doing.
Directory where web pages, slides and thumbs will be written (default is current directory).
Theme name (looked up in theme directory) or theme full path.
Default style to apply to the theme.
Common variables to load all templates with, e.g.
--template-vars='footer=foo bar,color=baz'. For
longer variable contents, it is easier to use a configuration
Force rebuild of web pages, regardless of the modification times of their dependencies. This is handy when changing a configuration option affecting these (theme, directory flattening, etc.).
Clean destination directory of files that should not be there (default is to print a warning but not to delete).
Exhaustively go through all directories regardless of source modification time.
Size of images, define as
small=800x600,medium=1024x768. The special dimensions
0x0 use original size. Refer to the IMAGE RESIZE DESCRIPTION section
for more information on the available syntax.
Size of thumbnails, eg. 150x113. Refer to the IMAGE RESIZE DESCRIPTION section for more information on the available syntax.
Quality of generated JPEG images (default is 85).
Include original photos in output.
Do not copy original photos in output directory, instead
link them using
RELATIVE_PATH as base
for those links (discarded without
Do not copy original photos in output directory, instead create symlinks to their original locations. This is useful when you plan transferring the whole directory which lazygal generated to some other location, perhaps with rsync, and you wish to avoid creating an extra copy of each photo.
This option is not available on Windows; if you try to use it on that operating system, lazygal will immediately exit with an exit status of 1.
Publication URL (only useful for feed generation).
Generate metadata description files where they don't exist in the source tree instead of generating the web gallery. This disables all other options.
Maximum number of thumbs per index page. This enables index pagination (0 is unlimited).
If set, lazygal will only export the pictures that have one
of their (IPTC) tags matching TAG.
It is also possible to use an equivalent of AND and OR boolean tests to filter tags.
For more details, read below the section
Sort order for images in a subgallery, among 'mtime',
'filename', or 'exif'. (default is 'exif' which is by EXIF date if
EXIF data is available, filename otherwise, sorting EXIF-less
images before). Add ':reverse' to reverse the sort order
Sort order for subgalleries, among 'exif' (EXIF date of the
latest picture in sub-gallery), 'mtime' or 'dirname' (default is
'dirname'). Add ':reverse' to reverse the sort order
Level below which the directory tree is flattened. Default is no flattening ('No').
This option makes the program include the web gallery index
of child galleries in their parent's gallery index, if their level is
greater than the supplied
LEVEL. The level
of the album root is 0.
Index pages with multiple galleries (which happens when this section is used) show the pictures links in gallery sections.
The following examples show the produced indexes for a sample album (2 sub-galleries, 1 sub-sub-gallery, 1 picture in each one of those).
Example 1. --dir-flattening-depth=No (default)
index.html <- sub-gallery links subgal1/index.html <- index with img1 subgal1/img1.html subgal1/subsubgal1/index.html <- index with img2 subgal1/subsubgal1/img2.html subgal2/index.html <- index with img3 subgal2/img3.html
Example 2. --dir-flattening-depth=0
index.html <- contains index for all pics subgal1/img1.html subgal1/subsubgal1/img2.html subgal2/img3.html
Example 3. --dir-flattening-depth=1
index.html <- contains index for all pics subgal1/index.html <- index with img1 and img2 subgal1/img1.html subgal1/subsubgal1/img2.html subgal2/index.html <- index with img3 subgal2/img3.html
Make a zip archive of original pictures for each directory.
Webalbum picture background color. Default is transparent, and implies the PNG format. Any other value, e.g. red, white, blue, uses JPEG.
What type of web album thumbnails to generate. By default,
lazygal generates the well-loved "messy" thumbnails with
randomly selected pictures from the album each rotated by a
random amount and pasted together. This default can also be
forced by specifying 'messy' as
On the other hand, specifying 'tidy' as the value of this option forces lazygal to skip the rotations, resulting in more regularly shaped thumbnails which can also be more densely packed. This can be an advantage if not all users of your albums have huge screens :-)
Do not remove GPS data from EXIF tags. By default the location tags are removed for privacy reasons. However, there are situations when having the location data makes sense and is desired. This is mostly meant to be used with holiday photos.
A theme maps to a directory that contains the following items:
Files to put in the web gallery
images or other ressources common to all galleries.
The XHTML template for the theme browse page (displaying one picture).
The XHTML template for the directory index page (pictures and sub-galleries links).
Depending on which index file is present, the theme will be:
dirindex.thtml: fully static
one HTML page per picture, per size and one index per size, or
only one index per directory is to be generated.
be valid XML. See
for syntax. Dependencies for statically included templates (i.e. with
filenames not computed from variables) are automatically computed: when
an included template is modified, the software will automatically figure
out which pages to re-generate. Missing template files will be searched for
(common ressources for the
shared directory) are
renamed to strip the
SHARED_ prefix and:
Processed using the Genshi text template engine (see
for syntax.) if their file extension starts with
Copied to the web album destination otherwise.
Please refer to the examples supplied in
If a directory from the source album contains a file named
album_description, it is processed as a source
of album metadata. The format is borrowed from another album
generating tool - Matew. Each line is treated as one possible tag,
unknown lines are simply ignored. Example content of this file
Example 4. album_description
Album name "My album" Album description "Description, which can be very long." Album image identifier relative/path/to/image.jpg
Otherwise, the user can provide metadata in the following files.
The title to use for this album directory.
The description for this album directory. HTML tags are used verbatim from this file.
The image to use at the top of the album picture stack.
The description to use for this particular image. Please note that HTML tags are taken as provided in this file for output in the templates.
Multiple configuration files are processed by lazygal.
The configuration is initially set up with the defaults. The defaults
can be found in the lazygal source distribution in
Then, the configuration files are processed in the following order, each newly defined value overloading formerly defined values.
Finally, any command-line-provided parameter takes precedence on any configuration file value.
User configuration file. See
lazygal.conf(5) for format.
Album root configuration file. See
lazygal.conf(5) for format.
Web gallery configuration file. Only the
template-vars sections are red in these
files. The configuration applies to the gallery representing the
directory of the configuration file, and all of its sub-directories,
unless another configuration file in a sub-directory overloads some
of the defined configuration values. See
lazygal.conf(5) for format.
The size string follows the same syntax as ImageMagick's.
Height and width both scaled by specified percentage.
Height and width individually scaled by specified percentages.
Width given, height automatically selected to preserve aspect ratio.
Height given, width automatically selected to preserve aspect ratio.
Maximum values of height and width given, aspect ratio preserved.
Minimum values of width and height given, aspect ratio preserved.
Width and height emphatically given, original aspect ratio ignored.
Change as per the supplied dimensions but only if an image dimension exceeds a specified dimension.
Change dimensions only if both image dimensions exceed specified dimensions.
Resize image to have specified area in pixels. Aspect ratio is preserved.
Tag filtering supports regular expression matching thanks to the 're' module of Python. All the filter matchings can be indicated to lazygal by successive uses of the 'filter-by-tag' option, or by giving a coma-separated list of keywords.
We illustrate here how more elaorated tag filtering can be done.
We want to export only the images that have the tags 'lazygal' AND 'hiking'.
$ lazygal --filter-by-tag=lazygal --filter-by-tag=hiking
$ lazygal --filter-by-tag=lazygal,hiking
We want to export the images that have the tags 'lazygal' OR 'hiking'.
$ lazygal --filter-by-tag="(lazygal|hiking)"
We want to export the images that have one of the tags 'hiking_2012', 'hiking_2013', 'hiking_France', etc.
$ lazygal --filter-by-tag="hiking_.*"
We want to export the images that have the tag 'lazygal', AND one of the tags 'hiking_2012', 'hiking_2013', 'hiking_France', etc.
$ lazygal --filter-by-tag="lazygal,hiking_.*"
More information is available on the program website:
This manual page was written for the Debian™ system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 any later version published by the Free Software Foundation.
On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.