#jpeg #generate-static #flexbox #image #gallery #image-resizing #html

app galerio

Generate static HTML galleries from a directory containing JPEGs

4 stable releases

1.2.0 Dec 16, 2023
1.1.0 Nov 6, 2022
1.0.1 Nov 6, 2022

#116 in Template engine

MIT/Apache

345KB
281 lines

Galerio

Build status Crates.io Version Crates.io Downloads

Galerio is a simple generator for HTML flexbox galleries written in Rust. From a directory with JPEG files, it generates a self-contained gallery without external dependencies.

Demo gallery: https://tmp.dbrgn.ch/galerio-demo/

Features

  • Simple CSS3/Flexbox based gallery
  • Touch friendly lightbox for viewing images in full screen
  • ZIP download of entire gallery (can be turned off)
  • When resizing images, detect panorama photos and do not scale them

Screenshot

screenshot

Installing

Through cargo:

cargo install galerio

From Arch Linux AUR:

yay -S galerio

Building

cargo build --release

Note: Make sure to create a release build, otherwise processing will be insanely slow.

Usage

galerio 1.1.0

USAGE:
    galerio [FLAGS] [OPTIONS] <input-dir> <output-dir> <title>

FLAGS:
        --help                       Prints help information
        --no-download                Disallow full gallery download as ZIP
    -p, --resize-include-panorama    Resize panoramas as well
        --skip-processing            Skip processing image files
    -V, --version                    Prints version information

OPTIONS:
    -l, --max-large-size <max-large-size>    Max large image size in pixels
    -h, --height <thumbnail-height>          Max thumbnail height in pixels [default: 300]

ARGS:
    <input-dir>     Input directory
    <output-dir>    Output directory
    <title>         Gallery title

Example:

galerio /home/user/pictures/switzerland2020/ /srv/www/galleries/switzerland2020/ "Switzerland 2020"

License

Licensed under either of

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~22–32MB
~449K SLoC