Album

Album is a simple, secure, XML photo gallery that supports tagging, searching, and editing. It has three major components:

A shell script mkalbum that produces XML indices of photos, and generates thumbnails using ImageMagick.
An XSLT transform for displaying the XML in your web browser.
A Javascript engine for editing albums and doing tag searches. That's right, the search engine runs on the client

Dynamic content (PHP, CGI, etc.) on a server is difficult to make secure, so this photo album only allows static server content. As a result, when you use the Javascript editing engine to create new album files you must upload them by hand.

Download

Download the source code:

album-0.2.tgz

If you have any problems or find any bugs, please contact me.

Installation

Unpack the tarball into the parent directory of your photo albums.

% tar xvzf album-?.?.tgz -C /var/www/htdocs/photos

Make the shell script executable.

% cd /var/www/htdocs/photos; chmod u+x album/mkalbum

Set the album title and album base URL in album-conf.xml.

% vi album/album-conf.xml

The directory tree on your web server should look like this:

/var/www/htdocs/photos
|-- index.xml
|-- album
|   |-- album-conf.xml
|   |-- album-simple.css
|   |-- album.js
|   |-- album.xsl
|   |-- mkalbum
|   `-- movie.thumb.jpg
|-- hiking-pics
|   |-- index.xml
|   |-- 000_0312.jpg
|   |-- 000_0312.thumb.jpg
|   |-- 000_0313.jpg
|   `-- 000_0313.thumb.jpg
`-- skiing-pics
    |-- index.xml
    |-- 000_0407.jpg
    `-- 000_0407.thumb.jpg

Operation

In each album directory, run mkalbum to generate thumbnails and the index file.

% cd vacation-pics; ../album/mkalbum ../index.xml .

Editing an album requires Firefox. Click on the small # symbol in the top left to activate the album editor. You can tag images by selecting them and clicking Add tag and Remove tag. You can also add captions to images and or choose to hide them. When you have completed your editing, click Generate to produce an XML file which may be uploaded back to your server and placed in the album directory.