📷 Bash Script to generate static responsive image web galleries.
Switch branches/tags
Nothing to show
Clone or download
Latest commit 95106e6 Jan 11, 2018
Failed to load latest commit information.
.codeclimate.yml codeclimate shellcheck Jan 11, 2018
.gitignore test script for travis Jan 11, 2018
.travis.yml travis osx Jan 11, 2018
LICENSE Initial commit Nov 6, 2016
README.md macos homebrew Jan 11, 2018
gallery.sh fix some shellcheck warnings Jan 11, 2018
tests.sh travis icon and typo fix Jan 11, 2018



Build Status

Bash Script to generate static web galleries. No server-side programs (i.e. PHP, MySQL) required.


gallery.sh is simple bash shell script which generates static html thumbnail (image, photo) galleries using the convert and jhead command-line utilities. It requires no special server-side script to run to view image galleries because everything is pre-rendered. It offers several features:

  • Responsive layout
  • Thumbnails which fill the browser efficiently
  • Download the original image file
  • Nice and simple Bootstrap CSS layout
  • Locally previewable galleries by accessing images locally (e.g. file:///home/nils/pics/gallery/index.html)
  • JPEG header EXIF data extraction
  • Auto-rotation of vertical images

This combination of features makes a better user experience than pretty much all the big online photo hosts. All you need is a place to host your plain html and jpeg files. This can also be Amazon S3.


On a debian-based system (Ubuntu), just run apt-get install imagemagick jhead as root.

Under macOS you can install it with:


gallery.sh [-t <title>] [-d <thumbdir>] [-h]:
	[-t <title>]	 sets the title (default: Gallery)
	[-d <thumbdir>]	 sets the thumbdir (default: __thumbs)
	[-h]		 displays help (this message)

Example: gallery.sh or gallery.sh -t "My Photos" -d "thumbs"

gallery.sh works in the current directory. Just load the index.html in a browser see the output.

The directory should contain a bunch of JPEG (.jpg or .JPG) files. It does not work recursively. ZIP files (.zip or .ZIP) and movies (.mov, .MOV, .mp4 or .MP4) are also considered. They appear as a download button in the gallery.







GNU Public License version 3. Please feel free to fork and modify this on GitHub (https://github.com/Cyclenerd/gallery_shell).