Create a one-pager gallery in your shell.
Find a file
2025-10-03 11:46:04 +02:00
assets init v0.1.0 2025-10-02 19:53:03 +02:00
images init v0.1.0 2025-10-02 19:53:03 +02:00
output init v0.1.0 2025-10-02 19:53:03 +02:00
templates init v0.1.0 2025-10-02 19:53:03 +02:00
.gitignore init v0.1.0 2025-10-02 19:53:03 +02:00
build.sh init v0.1.0 2025-10-02 19:53:03 +02:00
Dockerfile init v0.1.0 2025-10-02 19:53:03 +02:00
LICENSE init v0.1.0 2025-10-02 19:53:03 +02:00
README.md ADD reference of GH mirror and demo page in README 2025-10-03 11:46:04 +02:00

Shellery

Simple SSG to create dynamic gallery one-pagers in your shell! Shell+Gallery

Issue Tracker and Requests


Features

Available:

  • Simple use without dependencies
  • no Javascript
  • Lightbox of image with anchor
  • Order of images via filename
  • Container available
  • Simple to modify (Pictures and Templates)

Ideas:

  • check file formats
  • remove exif data
  • conf file for options
  • anonymize file names
  • sections via file names

Not planned:


Usage

Docker / Podman

mkdir -p images output

podman run -v $(pwd)/images:/app/images -v $(pwd)/output:/app/output git.uphillsecurity.com/cf7/shellery:latest

Local

  • Clone
  • Put images into ./images/
  • ./build.sh
  • Check ./output/

Modify files accordingly.

Docker Build

Build and run:

docker build -t localhost/shellery .
docker run -v $(pwd)/images:/app/images -v $(pwd)/output:/app/output localhost/shellery

The generated gallery will be in ./output/index.html


Notes


Security

For security concerns or reports, please contact via hello a t uphillsecurity d o t com gpg.


License

Apache License

Version 2.0, January 2004

http://www.apache.org/licenses/

  • Commercial use
  • Modification
  • Distribution
  • Patent use
  • Private use
  • Limitations
  • Trademark use
  • Liability
  • Warranty