FGALLERY(1)

✨ FGALLERY 💖

okay bestie, gather round, because this is fgallery — the manual page for a static HTML+JavaScript photo album generator, and honestly? it's giving minimalist icon behavior. no cap.

---

🎀 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

so fgallery is a static photo gallery generator. no frills. it has a stylish, minimalist look, and it shows your photos and nothing else. periodt.

there's no server-side processing happening here — it's static generation only. the resulting gallery can be uploaded literally anywhere with zero extra requirements, and it works with any modern browser. but bestie, heads up: JavaScript is required to view the gallery. iykyk.

the gallery features a big ol' area for viewing a single image, plus a scrollable horizontal or vertical bar full of thumbnails. the orientation of that thumbnail bar? automatically chosen based on the size of the browser window. she's adaptive. she's ✨smart✨.

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 thing. they can also click on the thumbnails to jump quickly to another image. each image has a unique anchor tag, so the user can copy&paste the URL straight from the browser's address bar and it'll point to the currently displayed image. iconic.

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 from the originals, using either exiftran(1) or exifautotran(1). it can also optimize thumbnail generation by centering on faces if the -f option is used and facedetect(1) is installed. the generated images get automatically optimized using jpegoptim(1) and/or pngcrush(1) if those programs are installed. and if the original images contain color profiles, 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 controls 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. and 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. slay responsibly 💅

---

🌈 OPTIONS

• -h, --help — displays a list of options. your little helper fr fr.
• -v — verbose output (shows commands as they're being executed).
• -s — slim output (no original files and no 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>. absolute legend behavior, we love to see it 💜

---

and that's the whole thing bestie!! this lil beauty lives in the FGALLERY(1) manual, source dated 2022-11-27 — so go forth, generate your static album, and remember: no server, no problem 🫶✨🎀