NAME

       fgallery — static HTML+JavaScript photo album generator

SYNOPSIS

       fgallery  [-hvsioktrpdfg]  [-c  methods]  [-j  N]  [--max-full  WxH]  [--max-thumb WxH] [--min-thumb WxH]
                [--no-sRGB] [--quality Q] [--index URL]  [--geobase  URL]  [--geozoom  z]  input-dir  output-dir
                [album name]

DESCRIPTION

       fgallery  is  a  static  photo  gallery  generator  with  no  frills that has a stylish, minimalist look.
       fgallery shows your  photos,  and  nothing  else.   There  is  no  server-side  processing,  only  static
       generation.   The  resulting  gallery  can be uploaded anywhere without additional requirements and works
       with any modern browser.  JavaScript is required to view the gallery.  The gallery will feature  a  large
       area  for  viewing  a  single  image,  and  a scrollable horizontal or vertical bar with thumbnails.  The
       orientation of the thumbnail bar will be automatically chosen based on the size of  the  browser  window.
       The user can click on arrows to go to the next or previous image or use the arrow keys on the keyboard to
       do the same.  The user can also click on the thumbnails to quickly go to another image.  Each image has a
       unique  anchor  tag,  and  the user can copy&paste the URL from the address bar of the browser which will
       point to the currently displayed image.  Clicking on the previewed image will  display  the  original  at
       full resolution, unless the -s option is used.

       fgallery  reads  in  JPEG, PNG and TIFF images, and automatically generates preview images, backdrops and
       thumbnails using ImageMagick(1).  It will automatically correct the orientation of the  generated  images
       using  EXIF  tags  in  the  original  images,  using  either exiftran(1) or exifautotran(1).  It can also
       optimize the generation of thumbnails by centering on faces if the -f option is used and facedetect(1) is
       installed.  The generated images are automatically optimized using  jpegoptim(1)  and/or  pngcrush(1)  if
       these  programs  are installed.  If the original images contain color profiles, then the generated images
       will be converted to the sRGB colorspace using  tificc(1)  if  that  program  is  installed,  unless  the
       --no-sRGB option is used.

       fgallery  can  also  add  captions  to  images. These can either be read from the EXIF headers (using the
       Title, Description and optionally the Comment tags), or from an external file (using the same filename as
       the image but with a .txt or .xmp extension).  The -c option can be used  to  control  which  methods  of
       caption extraction will be used.

       You have to manually specify the directory with the original image files and the desired output directory
       for  the web gallery.  Optionally, you can specify a title for the gallery.  By default, the gallery will
       include a downloadable ZIP archive with the complete photo album, unless either the -d or  -s  option  is
       used.   After  the gallery has been generated, you may have to change the file permissions using chmod(1)
       to allow them to be read by others.

OPTIONS

       -h, --help
               Display a list of options.

       -v      Verbose output (show commands as being executed).

       -s      Slim output (no original files and downloads).

       -i      Include individual originals in the generated album.

       -o      Do not auto-orient images.

       -k      Do not modify source files, keep originals.

       -t      Do not sort images on time.

       -r      Reverse the order of the images.

       -p      Do not automatically include full-sized panoramas.

       -d      Do not generate a full album download.

       -f      Improve thumbnail cutting by performing face detection.  Requires facedetect(1) to be installed.

       -g      Respect GPS cooredinates of images

       -c methods
               Set the caption extraction method (txt, xmp,  exif,  cmt  or  none).   Multiple  methods  can  be
               specified by giving a comma-separated list.  The default is txt,xmp,exif.

       -j N    Use N threads to process the images.

       --max-full WxH
               Set the maximum full image size to WxH pixels. The default is 1600x1200 pixels.

       --max-thumb WxH
               Set the maximum size of thumbnails to WxH pixels. The default is 267x200 pixels.

       --min-thumb WxH
               Set the minimum size of thumbnails to WxH pixels. The default is 150x112 pixels.

       --no-sRGB
               Do not try to remap preview and thumbnail image color profiles to sRGB.

       --quality Q
               Set the JPEG quality of the preview images to Q.  The default is 90.

       --index URL
               Specify the URL location for the index and back buttons.

       --geobase url
               Specify the URL location geolocation (default: http://osm.org) (when --geobase is specified -g is
               implicitly set)

       --geozoom z
               Specify  the  zoom  level of geo maps (default: 17) (when --geozoom is specified -g is implicitly
               set)

SEE ALSO

       ImageMagick(1), exiftran(1), exifautotran(1), jpegoptim(1), pngcrush(1),  tificc(1),  facedetect(1)  (see
       https://www.thregr.org/~wavexx/software/facedetect/).

AUTHORS

       fgallery was written by Yuri D'Elia <wavexx@thregr.org>.

                                                   2022-11-27                                        FGALLERY(1)