Place some images and movies in a directory and simply run
It will generate an index file and some slides.
You may add or remove some images in the working directory, and re-run
with different options to update the gallery contents
If an image has been modified, you may have to force the regeneration
of thumbnails and scaled images with -f
If your images are large, you should try
llgal --sy 480
to limit the height of the image to 480 pixels in slides.
Note that a click on the slide will actually open the
original full-size image.
You may even ignore the original images completely by passing
so as to remove links from slides' scaled images
to the original unscaled full images.
You may set the title on the command line through:
llgal --title "My title"
To change captions, the easiest way is to ask llgal
to generate captions first, with:
Then, you may edit the captions file (.llgal/captions
to update all captions.
You then run llgal
again, it will detect the existence
of the captions file and use it.
Captions and special slides
When generating the captions file with --gc
may automatically generate several fields for each image.
Available fields are image comments
will try to generate each field and concat them
to create the caption.
To generate captions from the filename only, run:
llgal --gc --cf
To generate captions from the image timestamp (extracted from
Exif tags when existing) and filename:
llgal --gc --cf --ct
To generate captions from the image comments (extract from
JFIF or Exif), timestamp and filename:
llgal --gc --cc --cf --ct
These commands will generate a captions file that you might then
use when generating the gallery.
You might also directly generate captions during the gallery
generation through something like:
llgal --cc --ct
Note that if a captions file exists, command line options about
captions generation are omitted.
Also note that --cc
Image::ExifTool Perl module to be installed.
After generating the captions file with --gc
, you might add
a special slide containing only some text by inserting the following
line in the file:
TXT: the text that is shown in the slide ---- the caption under the slide
Regenerating the gallery will then add this slide.
The following line add a special slide with a link instead of plain text:
LNK: the url ---- the label of the link in the slide ---- the caption under the slide
If you do not want those slides containing a single link or text to appear like this,
you may use -L
so that they will be listed as a text line in the index.
You may also use LNKNOSLIDE:
entries to add links without slides.
will rescan the existing files and
add the missing ones at the end of the captions file.
You then re-run llgal
to update the gallery regarding the new captions file.
The captions file may also be used to keep track of the contents of a gallery.
Even if you do not add some captions or title in the captions file, you may use
it to list the exact set of images that you want to appear in the gallery.
The order of the slides might be changed with the sort
For instance, --sort=iname
sorts by name case insensitively,
sorts by date, in reverse order.
It is also possible to set the order by changing captions positions
in the captions file.
By default, llgal
does only include images and movies in the
It is possible to force it to use all existing files in the directory
It is also possible to exclude some files with --exclude regexp
is a Perl regexp. For instance, to exclude all
files starting with MVI
llgal --exclude 'MVI.*\.AVI'
File that were excluded might be reincluded by using the similar
Finally, it is always possible to exclude files by generating a captions
file and removing some entries.
Note that the captions file is a good way to keep the list of images that
are involved in the gallery, even if you do not want any caption.
The main layout of generated webpages is based on HTML templates
and a CSS style-sheet (llgal.css
It is possible to place modified versions of these files in the .llgal
directory (or in $HOME/.llgal/
) to change the layout.
Since converting images might be slow
not always regenerate thumbnails and scaled images. By default, it only does if the
original images has been changed since last generation.
To force regeneration, for instance if you changed the thumbnails (with --tx
) or scaled images dimensions (with --sx
you may use -f
By default, the width and height of thumbnails are both limited. Both dimension
limits may be changed with --tx
, but changing a single
one does affect the other one. It means that the other should be changed too in
most of the circumstances.
Note that changing one of these options requires to
force regeneration of thumbnails
has been designed to create fixed-size slides. If, instead, you would like your
images in slides to follow the size of the window, you may use the slide_dimensions_from_css
option, either from a configuration file or with --option
on the command line.
will then remove all absolute dimensions for images in HTML slides.
Finally, you will be able to set the image width through the CSS slide sheet (llgal.css
for instance by adding width: 100%
in table.slide td.image-slide img
All text that appears in generated slides might be configured through configuration
One day, there might be a full internationalization support through gettext
By default, you need to click on Next
to go to the next slide.
If you passed --sx
, clicking on the slide will lead you to the
original image. If not, clicking does nothing.
If you want this click to jump to the next slide, you just need to modify the slidetemplate
and regenerate the gallery.
Of course, if you keep using --sx
, you will get into problems
since there will be 2 hyperlinks on each slide.
All non-image slides and thumbnails are usually basic text.
It is possible to force llgal
to use a special thumbnail or scaled image
by adding a special file in the local .llgal
directory with prefix
For instance, mythumb_image24.jpg
will be used as a thumbnail for image
will be used for sub-directory subdir3
will be used as a scaled image for movie bar.avi
The extension for the thumbnail or scaled image may be any image extension
Most images contains some meta-data called EXIF tags that may be useful to some people.
can display a table of some EXIF values under each image slide.
The name of the tags correspond to what the exiftool
(see for instance exiftool --list
llgal --exif Aperture,FocalLength,ImageHeight,ImageWidth,FileModifyDate
Note that --exif
requires the Image::ExifTool Perl module to be installed.
If you like using the same options for all your galleries and don't
want to remember the option, you may ask llgal
a configuration file with:
llgal --gencfg my_llgalrc
This file might be used later with
llgal --config my_llgalrc
It may also be placed in the user llgal configuration file
The configuration file contains a list of configuration lines.
All command line options, and even much more, are available by
It is possible to pass any configuration option on the
command line with --option
For instance, to set which file extensions llgal
match to find movies, use:
llgal --option 'movie_extensions="mpe?g|avi|mov|ogm"'
Multiple directories and subdirectories
If your photos are organized in several subdirectories of the working directory,
you can use -P
to take the photos from them instead of from the working
llgal -P subdir1 -P subdir2 -P subdir3
If you want these subdirectories to appear as sections, llgal
a horizontal line between each subdirectory and add a title in the index with --Ps
can display the title as regular text in the index instead
of a text thumbnail with -L
llgal -P subdir1 -P subdir2 -P subdir3 --Ps -L
As usual, these horizontal lines and titles are generated as TXT and LINE entries
are processed from the captions file. Thus, you may start by creating a captions file,
edit it and then generate the gallery.
llgal -P subdir1 -P subdir2 -P subdir3 --Ps --gc
Instead of passing -P
for each subdirectory, you may ask
to include all images from all subdirectories.
You may a the list of files of a subdirectory to an existing gallery if its
captions file if available, by regenerating it:
llgal -P newsubdir --gc
The directory contents is added at the end of the captions file, which may
be reordered by the user.
The gallery may then be regenerated from the new captions file by re-running
If your directory contains subdirectories, you might use -S
to create slides linking to these subgalleries.
, the subgalleries will even be generated right after
the main gallery.
The list of subgalleries might be changed by modifying DIR:
entries in the captions file.
Galleries that were created recursively (with -R
) may be
linked with their parents, children and brothers.
If you plan to regenerate some galleries independently, you should
take care of saving the configuration with --gencfg
generating a captions file.
All linking information is stored inside these files.
Regeneration is then easy (with --config
in the first case).
Assuming you have a main directory containing multiple subdirectories where you
created sub-galleries, you may do:
llgal -L -s
will create text links instead of thumbnails linking to sub-galleries,
will avoid any slide to be created.
As you may want slides in the sub-galleries, adding -R
is not recommended here
would remove slides from both the main gallery and the sub-galleries.
If you need -R
anyway, you may for instance avoid this problem by dropping
on the command and inserting make_no_slides=1
in the main gallery
configuration file (.llgal/llgalrc
Since the local configuration file is used for the local gallery and not for
sub-galleries (even with -R
The HTML accesskey feature may be use to navigate in llgal
galleries with keyboard shortcuts. But as this feature is very browser
dependant and might conflict with some regular shortcuts in certain
browsers, it is not enabled by default in llgal
Access keys can be configured by changing the templates and adding
For instance, changing the slidetemplate.html
code to the
following one will define p
accesskeys to previous slide, next slide and return to the index.
It means that Alt+p
be the actual shortcuts in Mozilla Firefox.
<a href="<!--PREV-SLIDE-->" accesskey=p><!--PREV-SLIDE-LINK-TEXT--></a>
<a href="<!--INDEX-FILE-->" accesskey=i><!--INDEX-LINK-TEXT--></a>
<a href="<!--NEXT-SLIDE-->" accesskey=n><!--NEXT-SLIDE-LINK-TEXT--></a>
Note that the slide template might be modified by getting a copy with
in the local or user-wide configuration directory using --gt
erases all files that have not been modified regarding to their
original template. The captions
file does not have a template, so llgal
will only erase it if it contains the following line:
# REMOVE THIS LINE IF LLGAL SHOULD NOT REMOVE THIS FILE
When the user generates the captions
file himself, he is not supposed
to add this line, which means llgal
won't erase the file.
But, when the captions are generated with llgal --gc
, this line will be added
automatically. Hence, if the user modifies the captions
file, he should start
by removing this line first to protect his modifications from future erasing.
Note that llgal --cleanall
erases ALL files, even if you kept the above line
in the captions
option of llgal
enables generation of PHP slides
instead of HTML. By default, no PHP code is inserted. But, you may change the
templates to add some PHP code to do whatever you want, including handle
dynamic comments that people may add to your slides.
comes with some examples, including the directory
which gives a quick and dirty example to do so.
(and especially convert
) to generate
thumbnails (and scaled images if --sx
was passed). It can be
pretty long if you have lots of large images.
To avoid being slow everytime you re-run llgal
, thumbnails and scaled images
are only generated once
(except when the original has been modified since or when -f
is passed, see
Why does llgal ignore the image dimension limits that I give?
There might be some way to improve the overall speed of thumbnails and scaled images
generation by changing the corresponding command line with scaled_create_command
in the configuration file. You may for instance use
another conversion program which is more optimized than ImageMagick
your specific images.
See tweak_image_generation.txt in the examples in the documentation for details.
is only a gallery generator. Adding features to rotate images (for instance
using Exif tags) or modify images (for instance to apply some filters) would open the door
for thousands of options that llgal
does not really require (and the command line
interface is already pretty complex). We prefer keeping those features in other softwares
that the user runs before using llgal
. Also, there is no technical reason to
include such filters in llgal
. Applying them with another specialized software
before generating the gallery is as easy, and such software will always provide more features
is not supposed to be used for this
(see Why does llgal not provide any feature to rotate or modify images?
You should use an external tool earlier and then apply llgal on the scaled images.
If you really want to use llgal
to scale images down, you should use --sx
. The scaled images will be placed in .llgal/scaled_*
To drop the originals and use the scaled images directly, you should first remove the
originals from the main directory. Then move the scaled images from .llgal
the main directory and remove the scaled_
(rename 's@^\.llgal/scaled_@@' .llgal/scaled_*
should do the trick).
Finally, re-run the same llgal
command line without --sx
You should get the same gallery as before, without the links from the slides to the