--- name: "llgalrc" section: "5" platform: "linux" package: "llgal" version: "0.13.19-1.1" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/llgalrc" --- # llgalrc(5) Configuration file for llgal ## NAME llgalrc - Configuration file for llgal ## Names of generic llgal files: *captions\_header\_filename = "filename"* Name of the captions header file that is inserted at the beginning 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 \[**--uc \**\]. 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 \[**--ui \**\]. 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 \[**--ui \**\]. 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 \[**--ui \**\]. 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 \[**--ui \**\]. 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. This option is only available in system- and user-wide configuration files. Default is **.llgal/**. *index\_filename = "filename"* Name of the generated index file \[**-i \**\]. Default is **index**. *slide\_filenameprefix = "filename prefix"* Prefix of generated HTML slide filenames. Default is **"slide\_"**. Note that this prefix is used to decide what HTML to delete when **--clean** is passed. Setting this option to an empty string will make llgal remove *all* HTML files. *scaled\_image\_filenameprefix = "filename prefix"* Prefix used to determine slide-image filenames from original images (in case of **--sx** or **--sy**). 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**. *path\_separator\_replacement = "char"* Character to use to replace / in the thumbnail/scaled of subdir images. Default is **@**. ## Index: *index\_cellpadding = \* Cellpadding in the index table \[**-p \**\]. Default is **3**. *list\_links = \<0/1\>* Display links and text as regular text instead of thumbnails in the main gallery thumbnail index \[**-L**\]. Default is **0** (**disabled**). *pixels\_per\_row = \* Pixels per row of thumbnails in index \[**-wx \**\]. Default is **0** (**unlimited**). *thumbnails\_per\_row = \* Thumbnails per row in index \[**-w \**\]. Default is **5**. *thumbnails\_dimensions\_from\_css = \<0/1\>* Do not output any absolute thumbnails size in HTML code and assume the CSS style sheet will take care of it (in table.index \[td.thumb \[img\]\]). Default is **0** (**disabled**). *thumbnail\_height\_max = \* Maximal height of thumbnails \[**--ty \**\]. Default is **75**. Changing this value does not affect the maximal width (see *thumbnail\_width\_max*). *thumbnail\_width\_max = \* Maximal width of thumbnails \[**--tx \** \]. If **0** is used, the width is unlimited. If not **0**, all thumbnails are padded to the given width. Default is **113**. Changing this value does not affect the maximal height (see *thumbnail\_height\_max*). *show\_caption\_under\_thumbnails = \<0/1\>* Write captions under thumbnails \[**-u**\]. Default is **0** (**disabled**). *show\_film\_effect = \<0/1\>* Show film effect \[**--fe**\]. Default is **0** (**disabled**). *MVI\_link\_to\_target = \<0/1\>* Make movie thumbnails links point to the movie instead of the corresponding slide. Default is **1** (**link to the movie**). *FIL\_link\_to\_target = \<0/1\>* Make file thumbnails links point to the file instead of the corresponding slide. Default is **1** (**link to the file**). *DIR\_link\_to\_target = \<0/1\>* Make directory thumbnails links point to the movie instead of the corresponding slide. Default is **1** (**link to the directory**). *LNK\_link\_to\_target = \<0/1\>* Make link thumbnails point to the link instead of the corresponding slide. It is similar to using *LNKNOSLIDE:* entries instead of *LNK:*. Default is **1** (**link to the link target**). ## 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\_dimensions\_from\_css = \<0/1\>* Do not output any absolute image size in the HTML code and assume the CSS style sheet will take care of it (in table.slide td.image-slide img). Default is **0** (**disabled**). *slide\_width\_max = \* Maximal width of slides \[**--sx \**\]. Default is **0** (**unlimited**). *slide\_height\_max = \* Maximal height of slides \[**--sy \**\]. Default is **0** (**unlimited**). *text\_slide\_width = \* Default width of text slides. Default is **400**. *text\_slide\_height = \* 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**). *link\_between\_last\_and\_first = \<0/1\>* Generate links between last and first slides or galleries. Default is **1** (**enabled**). *make\_slide\_title\_from\_caption = \<0/1\>* Generate slide titles from captions \[**-k**\]. Default is **0** (**disabled**). *show\_exif\_tags = \* Display a table of EXIF tags under each image slide \[**--exif**\]. The tags are given with their name in **exiftool -list** and separated with a comma. *show\_all\_exif\_tags = \<0/1\>* Display a table of all available EXIF tags under each image slide \[**--exif**\]. *slide\_link\_to\_full\_image = \<0/1\>* Link scaled image in slides to full unscaled images \[**--nf**\]. Default is **1** (**enabled**). ## 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 llgal 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. The extension is removed, except for directories. \[**--cf**\]. Default is **0** (**disabled**). *make\_caption\_from\_extension = \<0/1\>* Generate captions from filenames with their extension. **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\_timestamp = \<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**). *slide\_counter\_format = "format"* Change the format of the counter on the slides. **%n** is replaced with the slide number, **%0n** gets leading zeros, and **%t** is replaced with the number of slides. Default is **"   (%0n/%t)"**. Slide counter may be disabled by setting to an empty string \[**--nc**\]. ## Text: *index\_title\_default = "string"* Default title of the gallery. May be overridden with \[--title \\] or TITLE: in the captions file. 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>>"**. *next\_slide\_link\_text = "string"* Label of the link from a slide to the next one. Default is **"Next>>"**. *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 "**. *alt\_film\_tile\_text = "string"* Text shown as an image alternative for the film tile in the index. Default is **"Film Tile"**. *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 \**\] Default is **"kB"**. *timestamp\_format\_in\_caption = timestamp format* Change the strftime format used when generating captions from image date \[**--ct \**\]. Default is **"%Y-%m-%d %H:%M:%S"**. *credits\_text = "string"* Credits text at the bottom of the index Default is **"created with \llgal\"**. ## 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 \**\]. This option may be used several times. Dot beginning files and html files are excluded by default. *include = "string"* Include files whose name matches and were previously excluded \[**--include \**\]. 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"**. ## Sections: *section\_dir = "subdir"* Include subdirectory contents in the gallery \[**-P \**\]. This option may be used several times. Subdirectory path must be given relatively to the working directory. Default is to use the content of the working directory. *recursive\_sections = \<0/1\>* Add all subdirectories to the list of sections \[--Pall\]. Default is **0** (**disabled**). *entitle\_sections = \<0/1\>* Add the subdirectory name as a title at the beginning each section \[**--Ps**\]. Default is **0** (**disabled**). *separate\_sections = \<0/1\>* Add a horizontal line at the beginning of each section in the index \[**--Ps**\]. Default is **0** (**disabled**). ## Recursion: *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**). ## Various: *additional\_configuration\_file = "filename"* Additional configuration file that is parsed immediately (before processing the following lines) \[**--config \**\]. This option may be used several times. *additional\_template\_dir = "path"* Additional template directories \[**--templates**\]. This option may be used multiple times. *codeset = "codeset"* Codeset to be set in HTML headers \[**--codeset \**\]. *language = "locale"* Language to be used for generated text in HTML pages \[**--lang \**\]. If set, the **LANGUAGE** environment variable might prevent this option from working. *scaled\_create\_command = "string"* Command to use to create scaled images for slides. Default is **"convert --scale \x\ -- \ \"**. See **THUMBNAILS AND SCALED IMAGES GENERATION** for details. *thumbnail\_create\_command = "string"* Command to use to create thumbnails for the index. Default is **"convert --scale \x\ -- \ \"**. See **THUMBNAILS AND SCALED IMAGES GENERATION** for details. *force\_image\_regeneration = \<0/1\>* Force regeneration of thumbnails and scaled images \[**-f**\]. Default is **0** (**disabled**). *verbose = \<0/1\>* Print notice messages \[**-v**\]. Default is **0** (**disabled**). *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"**. ## SEE ALSO [**llgal**(1)](/llgal/1.md) The *llgalrc* template file provided within the documentation directory. ## AUTHOR Brice Goglin