llgal - On-line gallery generator

llgal [-option1 -option2 ...]

llgal is a quick and easy program for placing your images and movies online with just one command-line. It generates a pretty good-looking set of static HTML slides even with its default settings. To try it out just run llgal in a directory with jpg, png, mpg, etc files and check the output in a web browser. You can adjust the appearance of the image gallery with the many options listed below or (if you know a bit of HTML) by modifying the llgal.css files in the .llgal/ subdirectory that appeared in your image directory, or by defining indextemplate.html or slidetemplate.html files.

llgal also checks for the existence of a $HOME/.llgal/ directory where users can store their own templates, overriding the site-wide /usr/share/llgal. (See FILES for details).

The HTML webpages are generated from the templates by replacing several fields (See TEMPLATES). The layout might be configured through the list of options that are given in LAYOUT.

llgal uses all images and videos it finds in the current directory. See SELECTING FILES to include directories or other files and excludes some filenames.

The index includes thumbnails that llgal generates from original images. It is possible to provide custom thumbnails by placing them in the .llgal/ directory with the mythumb_ prefix. Custom thumbnails for movies have to be suffixed with an image-type extension.

The slide pages may include a scaled image in the --bigxy or --bigxy option is passed. It is also possible to define custom scaled images with the myscaled_ prefix.

Note that all command line options (except those from BEHAVIOR OPTIONS), and even more, might be stored in a configuration file to help generation of multiple galleries with the same layout. See CONFIGURATION for details.

By default, llgal generates a gallery. If one of the following option is passed, it will process it and exit immediately.

--clean

Remove all files that llgal may have created earlier and that user did not modify since.

--cleanall

Remove all files that llgal may have created earlier. This includes thumbnails, scaled down slides, all HTML files, captions file, film effect picture, indextemplate and slidetemplate and the style-sheet file.

--gc

Generate slide captions in .llgal/captions file that you may edit. The format of this file is very simple. See CAPTIONS for details. These captions may then be modified by the user. The file will be automatically used next time llgal is invoked. --gc might also be used to update the captions file when new files were added to the working directory.

--gt [<dir>]

Copy template files to the directory. The special value local might be used for the local .llgal/ directory, while user might be used for the user template directory $HOME/.llgal/. Any other directory is acceptable. llgal will create the target directory if it does not exist. The argument is optional. Its default value is local. See FILES for details about template files.

-h, --help

Display brief help.

-v, --version

Display llgal version.

llgal behavior may be modified with the following options, either when generating a gallery or not.

--config <file>

Read the file file as a configuration. See CONFIGURATION for details. Note that --config may be used several times on the same command line.

-d <dir>

Operate on image files in directory <dir>, which is also where the HTML and thumbnail files will be generated. The default is the current directory.

-f

Force thumbnail regeneration. Also forces medium-slide regeneration if --bigxy or --bigy is given. Otherwise llgal will not regenerate these files if they already exist, and you may end up with stale copies. Definitely use -f between two runs where you've changed the value of --bigxy, --bigy or --con.

--gencfg <file>

Output configuration in file for a futur reutilization through --config. See CONFIGURATION for details.

--option 'variable = value'

Modify llgal configuration. See CONFIGURATION for details. Note that --option may be used several times on the same command line.

-R

Enable recursive mode. llgal will be run inside subdirectories. This option might be used either to generate galleries in all subdirectories, or their captions files, or to clean recursively, etc.

When generating a gallery, this option implies -S that means llgal will use all existing subdirectories in no captions file is defined. If a captions file is defined, only the DIR: entries will be entered recursively. See CAPTIONS for details abour

Note that recursive behavior does only use the contents of the captions file to choose which subgalleries to enter when generating the gallery or the captions file. All other behaviors, including recursive cleaning ( -R used together with --clean or --cleanall), will not check whether a subdirectory is in the captions file. All not-dot-begining subdirectories will be cleaned.

-A

All files in the current directory will get a slides, except .html or dot-begining files. Files are matched as images or movies first, and then reverted as simple files instead. See -S for details about adding slides for subdirectories.

--exclude <s>

Exclude files whose name matches <s>.

--include <s>

Include files whose name matches <s> and where previously excluded.

-S

Each subdirectory will get a dedicated slide. If a captions file exists, only the subdirectories that it defines will be processed. If no captions file exists, llgal will process all subdirectories but those whose name begins with a dot.

Contrary to -R this option will not make llgal run recursively in subdirectories. -S does only define the list of subdirectories that appear in the current gallery.

-a

Write image dimensions and sizes under each thumbnail on the index page, and under each slide if --bigy or --bigxy was passed. This only works if the ImageMagick command identify is present.

--ad

Like -a but write only the image dimensions.

--as

Like -a but write only the image sizes.

--asu <s>

Allow to define the unit used to show file sizes. Default is "kB".

--bigxy <n>

Like --xy but operates on the image slides, not the thumbnails. Scales image slides to some medium width and height (e.g. 400), adjusting their other dimension accordingly. Useful if your digital camera spits out large images, like 1600x1200. The originals aren't affected, but scaled copies of your images are generated and thumbnails link to these copies. Clicking on the scaled copies in the HTML slides lets users see the full unscaled images. You must use -f between two consecutive runs when you've changed the value of --bigxy.

--bigy <n>

Like -y but operates on the image slides, not the thumbnails. Scales image slides to some medium height (e.g. 400), adjusting their width accordingly. Useful if your digital camera spits out large images, like 1600x1200. The originals aren't affected, but scaled copies of your images are generated and thumbnails link to these copies. Clicking on the scaled copies in the HTML slides lets users see the full unscaled images. You must use -f between two consecutive runs when you've changed the value of --bigy.

--cc [<s>]

Generates captions from image comment tag. If no argument is given, llgal first tries the standard comment (for instance JFIF or GIF), and then tries Exif comments if the previous one is empty.

An argument such as std or exif might be added to force the use of only standard comment or only Exif comment.

An argument such as exif,std will make llgal try Exif comment first.

An argument such as std+exif will use the combination of standard and Exif comments.

Passing --cc without argument is thus equivalent to passing --cc std,exif.

--cf

Generates captions from file names (strips suffix).

--ct

Add image timestamp tag to the generated captions.

--ctf strftime_format

Change timestamp in captions using a strftime format.

--con options

Command line options to pass on to convert internally (see its man page). This affects all thumbnails and, if --bigxy or --bigy is given, the medium-size slides too. You can set the -quality or go crazy with -negate, -noise, etc. (the last two only work with convert if ImageMagick is installed). --con may be used several times on the same command line.

-i <file>

Name of the main thumbnail index file. The default is index, as desirable for most web servers. The default extension is html and might be changed with --php or the www_extension configuration option.

-k

Use the image captions for the HTML slide titles. The default behavior is to use the image names.

-L

Do not create slides and thumbnails for links (including video, file and url), but list them after the main gallery index. Might be used when the directory only contains subgalleries and thus does not need any slide or thumbnail.

--li

Replace link labels in slides (usually Index, Prev and Next) with images (usually index.png, prev.png and next.png).

--lt

Replace link labels in slides (usually Prev and Next) with a thumbnail to preview previous/next slide. If passed together with --li, thumbnail preview is used for links to previous/next slide while the image is for the link to the index is kept.

-n

Use the image file names for the HTML slide files. Otherwise the default behavior is to simply name your slides 1.html, 2.html, and so on.

--nc

Omit the image count from the captions.

--next-gal <url>

Add links to the previous gallery located by <url>. This option is used internally for recursive galleries, and thus not documented in --help.

-p <n>

The cellpadding value of the thumbnail index tables. The default is 3.

--php

Change the default extension of generated webpages from html to php. Note that template names are not modified and keep their html extension even if they contain some PHP code. Note that llgal will only remove existing webpages corresponding to this extension when generating a new gallery or cleaning.

--parent-gal

Add links to the parent directory. This option is used internally for recursive galleries, and thus not documented in --help. These links are stored as a header and a footer for the index. The text in the links might be changed through the parent_gallery_link_text configuration option.

--prev-gal <url>

Add links to the previous gallery located by <url>. This option is used internally for recursive galleries, and thus not documented in --help.

-r

Omit the film effect altogether. For a simpler look you can also set the thumbnail background to be the same as the main index page background with the tile background-color option in the llgal.css file.

--Rl

Add links between subgalleries.

-s

For the simplest setup, omit all HTML slides. Clicking the thumbnails on the main page will just take users to the plain image files.

--sort [rev]<name|iname|size|time|none>

Change sort criteria when scanning files in the working directory. Default is "name". Setting to the empty string means none. iname is case insensitive sort by names. date means time. rev might be added for reverse sort.

-t <n>

Height (in pixels) of the tiled image used to simulate the top and bottom film effect on the thumbnail index page. This is 21 for the default tile.png image used, but you should set it otherwise if you replace that file with your own design.

--templates <dir>

Add a directory to the list of template locations.

--title <s>

Substitutes the string <s> for <!--TITLE--> in the index. The default is Index of Pictures.

-u

Write image captions under each thumbnail on the index page. If you have a captions file, then the captions are read from there.

--uc <url>

Assume the CSS file is available on <url> and thus do not use a local one. If ending with a slash, the CSS filename will be appended.

--ui <url>

Assume that the filmtile image and index/prev/next slide link images are available on <url> and thus do not use local ones. Their filename will be appended to the given location. Each image location may be also changed independently (See CONFIGURATION for the list of configuration options).

-w <n>

Set the thumbnail rows to be <n> images wide in the main index file. Default is 5.

--www

Make all generated files world-readable.

--wx <n>

Set the thumbnail rows to be <n> pixels wide at maximum. The number of thumbnails per row, given in -w is reduced if necessary. Default is to honor -w without regard to the resulting row width.

--xy <n>

Scale thumbnails to <n> pixels along their longest dimension.

-y <n>

Scale all thumbnails to the same height of <n> pixels. The default is 75.

When called with --gc llgal generates (or updates if already existing) the captions file in the .llgal/ subdirectory.

When --gc is not passed, if the captions file exists, llgal will automatically use it to generate slide captions in the gallery. If captions does not exist, llgal generates captions on the fly and use them in the gallery.

Generating the captions file with --gc before actually using it makes it possible to modify them (especially to add comments) or change the order of the slides in the gallery

IMG: <filename> ---- <caption> defines an image (when omitted, IMG: is the default type). MVI: <filename> ---- <linktext> ---- <caption> defines a movie. TXT: <text in slide> ---- <caption> defines a text slide. LNK: <url> ---- <linktext> ---- <caption> defines a link slide. FIL: <url> ---- <linktext> ---- <caption> defines a link to another file (typically neither an image nor a movie) DIR: <dir> ---- <linktext> ---- <caption> defines a subdirectory slide. TITLE: <title> defines the title of the gallery. INDEXHEAD: <one header> defines a header (multiple ones are possible). INDEXFOOT: <one footer> defines a footer (multiple ones are possible). PARENT: <linktext> defines the label of the link to the parent gallery. PREV: <linktext> ---- <url> defines the label of the link to the previous gallery located by <url>. NEXT: <linktext> ---- <url> defines the label of the link to the next gallery located by <url>.

Note that you can use whatever HTML syntax in the captions.

Line begining with a # are ignored.

When generating a captions file, the captions.header file is inserted at the top of the file to detail the syntax.

Before parsing command line options, llgal reads several configuration files. It starts with /etc/llgal/llgalrc then reads $HOME/.llgal/llgalrc and finally the .llgal/llgalrc file in the gallery directory. Additional configuration files may also be defined with the --config option.

These files may change llgal configuration in the same way command line options do, and even more. All following options may also be used on the command line through --option 'variable = value'.

See also /etc/llgal/llgalrc for details about these options and their default values.

llgal directories:

llgal_share_dir = path" The location of llgal share directory where template are stored. Usually /usr/share/llgal/ or /usr/local/share/llgal/. user_share_dir = " path" The location of the per-user share directory where template are stored. If they exists, these files are used instead of the system-wide files. Default is $HOME/.llgal/. template_dir = " path" Additional template directories [--templates]. This option may be used multiple times.

Names of generic llgal files:

captions_header_filename = " filename" Name of the captions header file that is inserted at the begining of generated captions files. Default is captions.header. css_filename = " filename" Name of the CSS file. Default is llgal.css. filmtile_filename = " filename" Name of the film tile image. Default is tile.png. Note that it must match the one that is used in the CSS file. index_link_image_filename = " filename" Change image name for link to the index. Default is index.png. next_slide_link_image_filename = " filename" Change image name for link to the next slide. Default is next.png. previous_slide_link_image_filename = " filename" Change image name for link to the previous slide. Default is prev.png. indextemplate_filename = " filename" Name of the HTML index template. Default is indextemplate.html. slidetemplate_filename = " filename" Name of the HTML slide template. Default is slidetemplate.html.

Location of llgal files if available on the web

css_location = " url" The location of the CSS on the web instead of a local one. If ending with a slash, css_filename will be appended. filmtile_location = " url" The location of the filmtile image on the web instead of a local one. If ending with a slash, filmtile_filename will be appended. index_link_image_location = " url" The location of the index link image on the web instead of a local one. If ending with a slash, index_link_image_filename will be appended. prev_slide_link_image_location = " url" The location of the prev slide link image on the web instead of a local one. If ending with a slash, prev_slide_link_image_filename will be appended. next_slide_link_image_location = " url" The location of the next slide link image on the web instead of a local one. If ending with a slash, next_slide_link_image_filename will be appended.

Location and name of generated files:

local_llgal_dir = " subdirectory name" The name of the subdirectory where llgal generated files will be stored. Default is .llgal/. index_filename = " filename" Name of the generated index file [-i <s>]. Default is index. slide_filenameprefix = " filename prefix" Prefix of generated HTML slide filenames. Default is "". slide_filenameprefix_nofile = " filename prefix" Prefix of slide filenames when generated from filename while there's no file associated (text, link, ...). Default is "NOFILE". scaled_image_filenameprefix = " filename prefix" Prefix used to determine slide-image filenames from original images (in case of --bigxy or --bigy). Default is "scaled_". thumbnail_image_filenameprefix = " filename prefix" Prefix used to determine thumbnail filenames from original images. Default is "thumb_". captions_filename = " filename" Name of the caption file that will be generated when llgal is called with --gc, or will be automatically used if it exists to generate slide captions. Default is "captions. user_scaled_image_filenameprefix = " filename prefix" Additional prefix of user-provided scaled images. Default is my. user_thumbnail_image_filenameprefix = " filename prefix" Additional prefix of user-provided thumbnails. Default is my.

Index:

index_cellpadding = <pixels> Cellpadding in the index table [-p <n>]. Default is 3. list_links = <0/1> List links after the main gallery thumbnail index [-L]. Default is 0 (disabled). pixels_per_row = <pixels> Pixels per row of thumbnails in index [-wx <n>]. Default is 0 (unlimited). thumbnails_per_row = <pixels> Thumbnails per row in index [-w <n>]. Default is 5. thumbnail_height_max = <pixels> Maximal height of thumbnails [-y <n>]. Default is 75. thumbnail_width_max = <pixels> Maximal width of thumbnails [--xy <n> ]. Default is 0 (unlimited). show_caption_under_thumbnails = <0/1> Write captions under thumbnails [-u]. Default is 0 (disabled). show_no_film_effect = <0/1> Omit film effect [-r]. Default is 1 (enabled). filmtile_height = <pixels> Film tile height [-t <n>]. Default is 21.

Slides:

make_no_slides = <0/1> Make no slides [-s]. Default is 0 (make slides). make_slide_filename_from_filename = <0/1> Use filenames as slide filenames [-n]. Default is 0 (disabled). make_slide_filename_from_extension = <0/1> Also use extension in slide filename when generated from filename. Default is 0 (disabled). slide_width_max = <pixels> Maximal width of slides [--bigy <n>]. Default is 0 (unlimited). slide_height_max = <pixels> Maximal height of slides [--bigxy <n>, --bigy <n>]. Default is 0 (unlimited). text_slide_width = <pixels> Default width of text slides. Default is 400. text_slide_height = <pixels> Default height of text slides. Default is 300. index_link_image = <0/1> Use an image instead of a text label for the link to the index [--li]. Default is 0 (disabled). prev_slide_link_image = <0/1> Use an image instead of a text label for the link to the previous slide [--li]. Default is 0 (disabled). next_slide_link_image = <0/1> Use an image instead of a text label for the link to the next slide [--li]. Default is 0 (disabled). prev_slide_link_preview = <0/1> Use a thumbnail preview instead of a text label for the link to the previous slide [--lt]. Default is 0 (disabled). next_slide_link_preview = <0/1> Use a thumbnail preview instead of a text label for the link to the next slide [--lt]. Default is 0 (disabled). make_slide_title_from_caption = <0/1> Generate slide titles from captions [-k]. Default is 0 (disabled).

Captions:

captions_removal_line = " string" This line will be added to the caption file llgal will generate when called with --gc. If the user doesn't want igal to remove this caption file when called with --clean, he just needs to remove this line from the file. Default is "REMOVE THIS LINE IF LLGAL SHOULD NOT REMOVE THIS FILE". make_caption_from_filename = <0/1> Generate captions from filenames [-C]. Default is 0 (disabled). make_caption_from_image_comment = ,-separated strings of +-separated strings Generate captions from image comment tag [--cc]. Default is "" (disabled). make_caption_from_image_comment = <0/1> Add image timestamp to generated captions [--ct]. Default is 0 (disabled). show_dimensions = <0/1> Show image dimensions [-a, -ad]. Default is 0 (disabled). show_size = <0/1> Show file sizes [-a, -as]. Default is 0 (disabled). show_no_slide_counter = <0/1> Do not show slide counter in captions [--nc]. Default is 0 (show counter).

Text:

index_title = " string" Title of the gallery [--title <s>]. Default is "Index of pictures". parent_gallery_link_text = " string" Label of the link to the parent directory. Default is "Back to parent gallery". prev_gallery_link_text = " string" Label of the link to the previous gallery. Default is "Previous gallery ". next_gallery_link_text = " string" Label of the link to the next gallery. Default is "Next gallery ". index_link_text = " string" Label of the link from a slide to the index. Default is "Index". prev_slide_link_text = " string" Label of the link from a slide to the prev one. Default is "Prev&gt;&gt;". next_slide_link_text = " string" Label of the link from a slide to the next one. Default is "Next&gt;&gt;". MVI_link_text = " string" Text prefixing the filename when generating link text for movies without a captions file. Default is "Open movie ". FIL_link_text = " string" Text prefixing the filename when generating link text for files without a captions file. Default is "Download file ". DIR_link_text = " string" Text prefixing the filename when generating link text for directories without a captions file. Default is "Open subgallery ". alt_full_text = " string" Text shown as an image alternative for full-size images in slides. Default is "". alt_scaled_text = " string" Text shown as an image alternative for scaled images in slides. Default is "Scaled image ". alt_thumbnail_text = " string" Text shown as an image alternative for thumbnails in the index. Default is "Thumbnail ". over_scaled_text = " string" Text shown when the mouse pointer is over a scaled image in a slide. Default is "Click to see full size ". over_thumbnail_text = " string" Text shown when the mouse pointer is over a thumbnail. Default is "Click to enlarge ". over_index_link_text = " string" Text shown when the mouse pointer is over a link from a slide to the index. Default is "Return to the index". over_prev_slide_link_text = " string" Text shown when the mouse pointer is over a link from a slide to the previous one. Default is "Previous slide ". over_next_slide_link_text = " string" Text shown when the mouse pointer is over a link from a slide to the next one. Default is "Next slide ". show_size_unit = " string" Unit to be used when printing sizes [--asu <s>] Default is "kB". timestamp_format_in_caption = timestamp format Generate captions from image comment tag [--ctf <s>]. Default is "%Y-%m-%d %H:%M:%S". credits_text = " string" Credits text at the bottom of the index Default is "created with <a href="http://home.gna.org/llgal">llgal</a>".

Recursion:

make_recursive = <0/1> Run recursively in subdirectories [-R]. Default is 0 (disabled). link_subgalleries = <0/1> Add links between subgalleries [--Rl]. Default is 0 (disabled). parent_gallery_link = <0/1> Add links to the parent directory [--parent]. Default is 0 (disabled). prev_gallery_link = <0/1> Add links to the previous subgallery [--prev-gal <url>]. Default is 0 (disabled). prev_gallery_link_target = " string" Target of the link to the previous subgallery [--prev-gal <url>]. next_gallery_link = <0/1> Add links to the next subgallery [--next-gal <url>]. Default is 0 (disabled). next_gallery_link_target = " string" Target of the link to the next subgallery [--next-gal <url>].

What files to insert in the gallery:

image_extensions = " |-separated strings" Extensions that are matched when searching images Default is "jpg|jpeg|png|gif|tif|tiff|bmp". movie_extensions = " |-separated strings" Extensions that are matched when searching movies Default is "mpg|mpeg|avi|mov|ogm|wmv". add_all_files = <0/1> Add all files to the list of entries, not only images and movies [-A]. Default is 0 (disabled). add_subdirs = <0/1> Add subdirectories to the list of entries [-S]. Default is 0 (disabled). exclude = " string" Exclude files whose name matches [--exclude <s>]. This option may be used several times. Dot begining files and html files are excluded by default. include = " string" Include files whose name matches and were previously excluded [--include <s>]. This option may be used several times. The order of includes and excludes is respected. sort_criteria = " string" Sort criteria when scanning files in the working directory. Default is "name".

Various:

convert_options = " string" Options to pass to convert [--con <s>]. This option may be used several times. Default is "". scaled_convert_options = " string" Additional options to pass to convert when creating slides. Default is "". thumbnail_convert_options = " string" Additional options to pass to convert when creating thumbnails. Default is "". force_image_regeneration = <0/1> Force regeneration of thumbnails and scaled images [-f]. Default is 0. www_access_rights = <0/1> Make all generated files world readable [--www]. Default is 0 (disabled). www_extension = " string" Extension of generated webpages [--php]. Default is "html". config_file = <s> Additional configuration file [--config <s>]. This option may be used several times.

When generation web pages, the following fields will be replaced from the templates by the associated value (computed by llgal).

<!--CSS--> The CSS style-sheet. <!--CREDITS--> The credits line given by credits_text configuration option. LLGAL-CODESET The character encoding, usually set to iso-8859-1 or utf-8.

When generating the index from template indextemplate.html, the following additional fields will also be replaced.

<!--TITLE--> The title of the index. <!--HEADERS--> The list of headers that are given in the captions file. <!--FOOTERS--> The list of footers that are given in the captions file. LLGAL-OPTIONS The command line that was used to generate the gallery.

When generating slides from template slidetemplate.html, the following additional fields will also be replaced.

<!--SLIDE-TITLE--> The title of the slide. <!--INDEX-FILE--> The filename of the index. <!--INDEX-LINK-TEXT--> The label of the link to the index (might be an image). <!--PREV-SLIDE-->and<!--NEXT-SLIDE--> The filename of the previous and next slides. <!--NEXT-SLIDE-LINK-TEXT-->and<!--PREV-SLIDE-LINK-TEXT--> The label of the link to previous and next slides (might be an image). <!--THIS-SLIDE--> The actual contents of the slide (might be an image). <!--THIS-SLIDE-STYLE--> The style of the slide contents (is defined in the CSS style-sheet). <!--IMAGE-CAPTION--> The caption of the slide.

The language that llgal uses to generate text in HTML pages is chosen from the localization configuration. If the chosen language is available in llgal translations, it will be used instead of the default english.

As usual with gettext, it is possible to override the localisation configuration by changing LANG, LC_MESSAGES or LANGUAGE environment variables.

If the desired language is not available in llgal translations, or if the user wishes to change the text values, he might create an additional configuration file (or modify the system-wide one) to update all configuration options of the Text section.

If a filename contains non-ascii characters which are not safely representable in a URL, llgal will escape them using the method RFC 2396 specifies. This may raise problems if the web server has a different notion of character encoding than the machine llgal runs on. See also http://www.w3.org/TR/html4/appendix/notes.html#h-B.2

Note that all numerical options may be resetted to their default value by setting them a negative value.

/etc/llgal/llgalrc, $HOME/.llgal/llgalrc, .llgal/llgalrc System-wide, per-user and local configuration files. See CONFIGURATION for details. /usr/share/llgal/captions.header Captions syntax description file that is inserted at the top of generated captions file. /usr/share/llgal/llgal.css The default style-sheet template. /usr/share/llgal/tile.png The tiled image used for the film effect. /usr/share/llgal/index.png The link image used for the index. /usr/share/llgal/prev.png The link image used for the previous slide. /usr/share/llgal/next.png The link image used for the next slide. All files are required on the website. llgal will copy them to the local .llgal/ file during gallery generation.

/usr/share/llgal/indextemplate.html The default index template file. /usr/share/llgal/slidetemplate.html The default file used to generate slides. These files are not required on the website. But, llgal will use them to generate HTML webpages of the gallery by replacing several fields with text or images. See TEMPLATES for details.

The user may change all these templates by storing files with the same name in its user template directory $HOME/.llgal/ or in the local .llgal/ directory. The former defines user-specific templates that will be used each time the user generate a gallery. The later defines gallery-specific templates that will be used for the local gallery. A local template is used by default if it exists. A user template is used if it exists and no local template exists. Finally, system-wide templates are used if no local and user templates override them.

It is also possible to add custom template directories (with --templates) that will be used to get templates before trying in the user and in the system-wide template directories.

The option --gt might be used to get copies of template files in the local or in the user template directory.

Run llgal in a directory with jpg, gif, png, mpg or avi files to see what it does. Then play with the options described above and use -h if you need a quick listing.

There are always some. If you find any let me know.

Brice Goglin