PHOTOMOLO(1)

NAME
photomolo - generate thumbnails and HTML navigation for JPEG images

SYNOPSIS
photomolo [options] directory ...

DESCRIPTION
This manual page documents briefly the photomolo command.

photomolo eases the browsing of digital photographs in JPEG format by constructing HTML documents and thumbnail images for previewing the photographs in different resolutions. Optionally, the HTML output can be disabled, and photomolo can be told to remove the files it has created.

OPTIONS
photomolo follows the usual Unix command line syntax, with options starting with a dash (`-').

--  Stop processing options. This is useful if the first file name begins with a dash.

-T dir/s(2|4|8)
    Create thumbnail subdirectories dir, where each image is shrunk to 1/2, 1/4 or 1/8 of original resolution.

-T dir/[wwidth][hheight]
    Create thumbnail subdirectories dir, so that each image is shrunk to the specified maximum width or height, or both, preserving the aspect ratio.

-H htmlfile
    Output the HTML code to htmlfile in each thumbnail subdirectory. The default is index.html.

-C cssfile
    In the HTML code, refer to cssfile in the top-level directory. If directory/cssfile does not exist, it will be created.

-i iconfile
    Embed "icon" references to iconfile in the HTML.

-I file.ico
    Embed "shortcut icon" references to file.ico in the HTML, for Microsoft browsers.

-t  Generate thumbnail files only, no HTML or CSS.

-r  Remove each thumbnail directory specified with -T options.

EXAMPLE
The command photomolo -T .8/s8 -T .120/h120 -T .240/h240 images traverses the directory tree images and creates three types of thumbnail images: shrunk to an eighth (in subdirectories named .8), or to 120 or 240 pixels of height (.120 and .240). You probably want to create a file images/index.html that links to images/.8/index.html, images/.120/index.html, and images/.240/index.html.

For future reference, you may want to write the photomolo command in a shell script or a batch file. Subsequent runs of the command will be much faster, since thumbnail images will only be generated if they do not exist or the timestamps do not match.

BUGS
There is no mechanism for specifying the character set; ISO 8859-1 is assumed. Sorting criteria cannot be specified either. The files and directories are sorted according to image time stamps.

AUTHOR
Marko Mäkelä <msmakela@nic.funet.fi>. The bitmap scaling algorithm has been adapted from pnmscale(1) by Jef Poskanzer, and the JPEG decompression and compression algorithms are in libjpeg from the Independent JPEG Group.

SEE ALSO
exifiron(1), jpegcom(1).