short description:

opengallery takes a dirtree of image files and creates a web site with frames, thumbnails, subdirectory navigation and optional javascript highlighting. here's a simple example and here's a more complex example

full description:

opengallery is a shell script (with a couple helper programs written in 'c') to take a directory of image files (jpeg tga gif tiff png) and make a website (a set of four html files) and generate thumbnail image files for use in the website. Thumbnails help with browsing a large number of files; one can quickly scan a menu of thumbnails for the images one wants to review in detail - without having to download every full image. opengallery generates a website with three html frames - one for the subdir navigation, one for the thumbnails, and one for the desired image. Because of the frames, there's no need to hit the back button after viewing each and every image. Optionally uses javascript to highlight the current dir in the dirtree so one knows both where one is and where one has been. Can be run on one directory or a whole dirtree. Relies on convert and identify from the ImageMagick package to generate the thumbnails and find the width & height of existing thumbnails. Keeps the thumbnails in the ".thumbnails/" subdirectory. Tested with mozilla. Licensed under the GNU GPL.


To run opengallery on just one directory, run ogre (ogre = OpenGallery REcursive) from that dir. To run opengallery on a tree of directories (a dir and all its subdirs), use ogre -r. See doc/usage for more information on usage.


The rpm is the recommended way to go, if you have rpm installed and configured. Just rpm -i the current stable release and that's all you need to do.

From .tgz, opengallery is (almost) ready-to-run out-of-the-box; just un-tar (tar -xzf) the ".tgz" file, then run make from the directory that tar creates. After that, you're ready to run ogre from the the same directory. Alternately, there's an install-script to make it and install it to "/usr/local/bin" (by default), or to an arbitrary directory if one is specified on the command line. Additionally, there's the option of "make install", which will just run the install-script.

See doc/install for more information on installation.

required packages:

  • textutils
  • sh-utils
  • fileutils
  • readline
  • grep
  • gawk
  • findutils
  • sed
  • /bin/bash2
  • mktemp
  • coreutils

Chances are, you have all of these installed already (most of them are integral parts of the operating system and shell). The possible exception is ImageMagick (1) (2). A good place to look for the rest (if you need them) is the free software foundation (1) (2) (GNU's Not Unix!).

If you're installing from the .tgz or the .src.rpm, you will also need these:

  • make
  • gcc

back to opengallery home
valid html 4.01!