EmlGallery

EmlGallery (elementary Masonry & Lightbox Gallery) is a simple generator for Web galleries, based on Masonry, a library that beautifully tiles images on a page, and Lightbox, a library for presenting individual images nicely.

The Go source is a prototype I did a few years ago and kept here because it's fun to me that I used Go at some point!

License WTFPLv2.

Usage

Point the script to a folder with photos and it generates a JSON file with metadata, push it alongside your photos to a Web host and you are ready to go.

$ emlg "/home/dece/Photos/2022 dubious trip to antartica"
# "Data JSON saved."
$ ls $!
# → data.json  IMG1.jpg  IMG2.jpg  IMG3.jpg  …

The index.html file at the root of this repository is able to load the JSON data and build the gallery when someone visits your page. There are two ways to provide the JSON data to the gallery, explained below but also at the bottom of index.html itself.

First method: provide data.json as an URL

Host the HTML file somewhere and link it with the URL to your data.json as the fragment part of the URL (anything after the #).

Example: http://gallery.dece.space/#http://unrelated.host/

This method lets you host only one copy of the gallery page and provide different links for each gallery. One drawback is that the server hosting your images must have its CORS policy configured to let your browser load the photos.

Second method: embed data.json into the page

Override some variables as explained in index.html and you should be good to go. This method avoids the second request, but as you need to fetch the thumbnails anyway…