Album - Photo gallery generator which has theme support

From NAS-Central Buffalo - The Linkstation Wiki
Revision as of 17:58, 7 September 2006 by Ramuk (Talk | contribs)

Jump to: navigation, search



181_thumb.gif Screenshot of project album

What is it?

Album - [1] An HTML photo album generator that supports themes. It takes directories of images and creates all the thumbnails and HTML that you need.

Album is a perl script, which means you need to be comfortable with or prepared to use the command-line. If you just want a point-and-click, you may wish to look elsewhere. Features:

  • You can use themes to choose or redesign the album "look and feel."
  • Recursively descends directories to make a hierarchy of photo albums
  • EXIF support, Video thumbnails...
  • Has a plugin system that allows you to write perl code to alter the behavior of album.
  • Slideshows, transparent overlays, credit tags, easy captions, and endless features!

Look here for documentation: [2]


Minimum Requirements

  1. Apache or LightHTTPD or Thttpd
  2. The album perl script[3]
  3. Imagemagick tools (specifically 'convert')

Optional Installation

  1. Themes[4]
  2. ffmpeg (for movie thumbnails)

Install Imagemagik


Skip ahead to #Install Album, apt-get will resolve all dependancies for you


  1. Install Ipkg on the Linkstation (for end-users) and enable the NSLU2 Feed: Ipkg Package List: PowerPC
  2. Install imagemagick
ipkg install imagemagick

OpenLink (MIPSel)

Nuvola apps important.png 


  1. Install the Precompiled C development environment, running on the LS (to get Perl)
  2. Install imagemagik from source.[5]

Download ImageMagick.tar.gz from or its mirrors and unpack it with this command:

tar -xvzf ImageMagick.tar.gz

Next configure and compile ImageMagick:

 cd ImageMagick-6.?.?

If ImageMagick configured and compiled without complaint, you are ready to install it on your system. You need to be root to install. To install, type:

 make install

Install Album


apt-get install album


Nuvola apps important.png 


Download and run Album

tar -xvzf album.tar.gz
cd album-3.12
mkdir -p /usr/local/bin
cp album /usr/local/bin/
chmod 0755 /usr/local/bin/album

Running Album


  • You need a web directory to put themes and your photo album.[6] eg: /home/httpd/test the URL will be: http://myserver/test/
  • First create a directory and put some images in it. We'll call this: /home/httpd/test/Photos

Using A Theme

I use this theme:



Use wget to get and install this theme

mkdir /home/httpd/Themes/
cd /home/httpd/Themes/
tar -xvzf Dominatrix6.tar.gz
rm Dominatrix6.tar.gz

To use a theme, download the theme .tar or .zip and unpack it.

Themes are found according to the -theme_path setting, which is a list of places to look for themes. Those paths need to be somewhere under the top of your web directory, but not inside a photo album directory. It needs to be accessible from a web browser.

You can either move the theme into one of the theme_path-s that album is already using, or make a new one and specify it with the -theme_path option.

Then call album with the -theme option, with or without -theme_path:

 album -theme Dominatrix6 /home/httpd/test/Photos
 album -theme Dominatrix6 -theme_path /home/httpd/Themes/ /home/httpd/test/Photos

Medium images

Full resolution images are usually too big for a web album, so we'll use medium images on the image pages:

album -medium 33% /home/httpd/test/Photos


  2. MarginalHacks Album Documentation
  3. MarginalHacks: Album Download
  4. - Snapshots of all Album themes
  5. ImageMagick: Install from Source
  6. Album Documentation: MINI HOW-TO
Link.png This article is currently a stub. You can help this Wiki by expanding it

. This template will categorize articles that include it into Category:Stubs.