Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Build Status

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

Overview 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:

Usage [-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: or -t "My Photos" -d "thumbs" 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 (

You can’t perform that action at this time.