Bash script to generate static html photo albums
  • Shell 67.8%
  • Go Template 25.8%
  • Makefile 6.4%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-06-09 00:04:59 +03:00
bin Increment version to 0.6.0 2026-05-30 22:22:24 +03:00
share/templates/default update photo album with enhanced CSS animations and fix imagemagick command order 2026-05-30 22:20:53 +03:00
src update photo album with enhanced CSS animations and fix imagemagick command order 2026-05-30 22:20:53 +03:00
.version update version 2026-06-09 00:03:32 +03:00
changelog Increment version to 0.8.1 2026-06-09 00:04:59 +03:00
Makefile ShellCheck OK now. Also, some refactorings. 2022-02-20 10:18:39 +00:00
README.md add done note 2026-06-08 23:52:56 +03:00

photoalbum

photoalbum is a minimal Bash script for Unix like operating systems (such as Linux) to generate static web photo albums. The resulting static photo album is pure HTML+CSS (without any JavaScript!).

Note, this project is done. For a continuation see shuriken.sh.

Installation

Run the following commands to install it:

make
sudo make install

Also, as a requirement, ImageMagick needs to be installed. The script prefers the modern magick command and falls back to convert when needed.

Usage

    photoalbum clean|generate|version [rcfile] photoalbum
    photoalbum makemake
  • clean: Cleans up the workspace
  • generate: Generates the static photo album
  • version: Prints out the version
  • makemake: Creates a Makefile and photoalbumrc in the current working directory.

Example usage

  1. See if /etc/default/photoalbum fits your needs. If not, run photoalbum makemake, which will create a photoalbumrc file in the current directory.
  2. Adjust the incoming path in photoalbum. Point to a directory with all the pictures in it.
  3. Run make (or photoalbum generate) to generate it.
  4. Distribute the ./dist directory to a static web server.
  5. Clean the mess up with make clean or photoalbum clean

HTML templates

Poke around in this source directory. You will find a bunch of Bash-HTML template files. You could tweak them to your likings.