sitelen-mute | a static image gallery creator

sitelen-mute is a Perl library. sitelen-mute has no bugs, it has no vulnerabilities, it has a Strong Copyleft License and it has low support. You can download it from GitHub.

Sitelen Mute is a static photo gallery generator. It takes all the images it can find in the source directory and writes a static gallery to the output directory: scaled images, zipped originals, thumbnails, Javascript code for navigation, and an HTML file. You can upload this to a simple web server. -h, --help shows this help. -v increases the verbosity. Repeat for more detail. -s produces "slim" output: no original files or album to download. The default is to create a zip file with all the originals in it. Creating a zip files requires the zip or 7za (7-Zip). -i include originals as individual files. The default is to create a just a zip file with all the originals in it. -d skip creation of a full album zip file for download. Visitors can download it by clicking the floppy icon with the downward arrow in the top left corner. -c METHODS names the caption extraction methods, separated by commas. Valid options are txt, xmp, exif, cmt, and none. When multiple methods are provided, the first available caption source is used. By default, the method list is txt,xmp,exif. You can disable caption extraction entirely by using none. txt reads the caption from a text file that has the same name as the image, but with txt extension (for example IMG1234.jpg reads from IMG1234.txt). The first line of the file (which can be empty) constitutes the title, with any following line becoming the description. These files can either be written manually, or can be edited more conveniently using fcaption. It accepts a list of filenames or directories on the command line, and provides a simple visual interface to quickly edit image captions in this format. xmp reads the caption from XMP sidecar metadata and exif reads the caption from EXIF metadata. Tools such as Darktable or Geeqie can write such files. Use Ctrl+K to bring up the metadata editor. cmt reads the caption from JPEG or PNG's built-in comment data. Both JPEG and PNG have a built-in comment field, but it's not read by default as it's often abused by editing software to put attribution or copyright information. Captions can be controlled by the user using the speech bubble icon or by pressing the c keyboard shortcut, which cycles between normal, always hidden and always shown visualisation modes. -k prevents the modification of the image files. The default is to auto-orient images and to optimise JPEG and PNG files. Optimisation requires jpegoptim or pngcrush. -o prevents auto-orientation of images. Lossless auto-orientation requires one of exiftran or exifautotran. -t prevents sorting by time. Sorting by time is important if mixing the pictures of multiple cameras. -t reverses the album order. -p prevents the inclusion of full-sized panoramas. -n NAME sets the album name, i.e. the title in the browser window. --index URL is the location for the index/back button. The following three options add meta tags for previews on social media. They must all three be specified, if at all. --url URL is the eventual URL of the gallery. That is, you need to know where you're uploading the gallery to. --title TITLE is the title for previews on social media. --description DESCRIPTION is the (longer) description to use for the preview on social media. -f improves thumbnails by using face detection. This requires facedet. --noblur skips the generation of blurry backdrops and simply uses dark noise instead. --max-full WxH specifies the maximum full image size (the default is 1600×1200). --max-thumb WxH specifies the maximum thumbnail size (the default is 267×200). --min-thumb WxH specifies the minimum thumbnail size (the default is 150×112). --no-sRGB prevents the remapping of previews and thumbnail colour profiles to sRGB. The remapping requires tificc. --quality Q specifies the preview image quality (0-100, currently: 90). --link-orig method specifies the copy method to use: one of copy, hard, sym, or ref); the default is copy. copy uses regular cp; hard uses hard links: cp --link, or ln on BSD; sym uses symbolic links: cp --symbolic-link, or ln -s on BSD; ref uses lightweight copy, where the data blocks are copied only when modified: cp --reflink, and it is not supported on BSD. --viewdir specifies the directory containing CSS/JavaScript that is copied into the target directory. --version prints the version.