https://github.com/dbrgn/galerio

A simple generator for self-contained HTML flexbox galleries written in Rust.
https://github.com/dbrgn/galerio

gallery photography rust

Last synced: about 1 year ago
JSON representation

A simple generator for self-contained HTML flexbox galleries written in Rust.

• Host: GitHub
• URL: https://github.com/dbrgn/galerio
• Owner: dbrgn
• License: apache-2.0
• Created: 2020-12-06T16:48:43.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2023-12-16T22:47:03.000Z (over 2 years ago)
• Last Synced: 2025-06-29T00:39:09.918Z (about 1 year ago)
• Topics: gallery, photography, rust
• Language: Rust
• Homepage:
• Size: 390 KB
• Stars: 25
• Watchers: 2
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE-APACHE

Awesome Lists containing this project

README

          
# Galerio

[![Build status][workflow-badge]][workflow]

[![Crates.io Version][crates-io-badge]][crates-io]

[![Crates.io Downloads][crates-io-download-badge]][crates-io-download]

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: 

## 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](screenshot.jpg)

## 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]   

    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 image size in pixels

        -h, --height           Max thumbnail height in pixels [default: 300]

    ARGS:

             Input directory

            Output directory

                 Gallery title

Example:

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

## License

Licensed under either of

 * Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or

   http://www.apache.org/licenses/LICENSE-2.0)

 * MIT license ([LICENSE-MIT](LICENSE-MIT) or

   http://opensource.org/licenses/MIT) at your option.

### 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.

[workflow]: https://github.com/dbrgn/galerio/actions?query=workflow%3ACI

[workflow-badge]: https://img.shields.io/github/actions/workflow/status/dbrgn/galerio/ci.yml?branch=main

[crates-io]: https://crates.io/crates/galerio

[crates-io-badge]: https://img.shields.io/crates/v/galerio.svg?maxAge=3600

[crates-io-download]: https://crates.io/crates/galerio

[crates-io-download-badge]: https://img.shields.io/crates/d/galerio.svg?maxAge=3600