Yet another photo gallery, dead simple
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
galleries
.gitignore
README.md
build_gallery.rb
gallery.js
gallery_template.html
index_template.html
style.css

README.md

PhotoGal

PhotoGal generates a beautiful photo gallery from a plain directory of files.

It provides the features casual visitors will notice:

  • Thumbnails
  • Sharp modern appearance
  • Easy navigation controls

PhotoGal screenshot

It does NOT provide:

  • Photo editing - you will need to export into this from other software like Lightroom or Darktable.
  • Comments/likes/social media integration
  • Uploading photos to a server -- you will need to move the files yourself with utilities like SFTP or rsync.
  • Tagging and categorizing photos across galleries -- you can only have a simple list of galleries.
  • Rearranging photos to appear in a particular order -- you will need to rename the files to do this.

Detailed features

  • Navigation hotkeys
  • Large click area for navigation buttons
  • Thumbnail rows are automatically scaled to fill the page width. (Not a trivial problem!)
  • When viewing images full size, the neighboring images are preloaded for instantations switch

Dependencies

This requires Ruby and ImageMagick.

# Ubuntu Linux
sudo apt install ruby imagemagick

# Mac OSX (with Homebrew)
brew install ruby imagemagick

Setup

git clone https://github.com/allantokuda/photogal.git photos
cd photos/galleries

Put your photos into subfolders of the "galleries" folder, so your files look like

galleries/Example-Gallery-1/DSC_1234.jpg

Then run this script, which creates generates thumbnails and and creates the index.html files for each gallery:

./build_gallery.rb

Gallery configuration

Each gallery can have a config.yml file, e.g. galleries/Example-Gallery/config.yml. Examples:

Set a key image to represent the gallery on the site index:

key: DSC_4567.jpg

Make the gallery unlisted on the site index:

unlisted: true