iGal:  online Image GALlery generator

[ Download ]  (right-click and save)

         igal-1.4.tar.gz (22k) or igal-1.4-1.noarch.rpm (25k)
         also as a Debian, PLD and an OpenBSD package.
Online man page and ChangeLog.
Sample gallery1 and gallery2.

iGal featured in the Linux Journal!
Read (or contribute to) the feedback on Freshmeat.
See how people are using iGal.

Like iGal?
Support This Project

[ What is iGal? ]

iGal is a Perl program that can generate and publish an entire online picture show (static HTML slides, thumbnails and index page) with just one command line invocation in a Linux or Unix environment. If you've got a directory (or several) full of image files that are waiting to be put online and shared with friends, then iGal is for you.

[ Features ]

  • flexible, fully documented
  • handles JPG, GIF and PNG images
  • generates W3-validated static HTML slides
  • very configurable with command line options and HTML/CSS template files
  • slides use a JavaScript trick to preload the next image in the slide show (useful over slow connections!)
  • relies on programs already included with most Linux distributions (libjpeg [src, rpm] or ImageMagick [src, rpm]), not on non-standard Perl modules
  • should easily install and work on any Unix-like OS, including MacOS-X

[ Index page examples ]

igal -c -y 50

The -c switch was used because I had edited the .captions file to only include these three images. Also I reduced the height of the thumbnails with -y 50 from the default value of 75.

igal -c -y 50 -r --as

Here the "film reel" effect has been eliminated (with the -r option) and the background was set to match the gray background of this page (the default is black, or 000000). Also the --as option was used to display the image sizes.


[ Slide page examples ]


This is basically the default view of the area underneath a slide. The caption contains the file name and the image counter. (the border is drawn around the captured image fragment only for clarity).

igal -c -x

This is the area underneath a slide with a user-supplied caption (from the same .captions file used above). The image counter was omitted with the -x option.


[ FAQ ]

How do I install igal?
     From the tarball: tar zxvf igal-1.4.tar.gz then cd igal-1.4, read the README and make install (as root). From the rpm: rpm -Uvv igal-1.4-1.noarch.rpm (as root).

How do I relocate the rpm installation?
     Say that instead of /usr/local (the default) you wanted to install in /usr. Then try: rpm -Uvv --prefix /usr igal-1.4-1.noarch.rpm. Unfortunately you will also have to edit the 8th line of igal source code (if you know a more elegant way to get around this let me know).

Can I replace the plain-text "Index", "Prev" and "Next" links with something else?
     Yes! (but you need to know a bit of HTML). Run igal once and then edit the .slidetemplate.html file. Then rerun igal. If you want graphics (buttons) you'll need to supply your own. You have practically complete control over the look of the generated HTML slides thru the .slidetemplate.html file. Let me know of any nifty alternative looks you've got.

How do I change the order of the slides?
     First run igal -c then edit the generated .captions file. You can change the order of the slides, temporarily comment out some (with a # sign) or even remove them from the slide show at this point. Then rerun igal -c.

How do I rotate images 90 degrees?
     Preview the image files in your directory with xv (say xv *.jpg), right-click on the first image that comes up and page through the rest of them with Next/Prev. Rotate any images that need to be, save them with the same extension and then run igal. Otherwise you could also run jpegtran -rotate 90 or mogrify -rotate 90 (if you have ImageMagick) on the individual images that need to be rotated.

Eric Pop