PHOTOMOLO(1)                                                      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  cre-
       ated.

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, pre-
              serving 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.

       -c charset
              Assume that the image comments are in  the  specified  character
              encoding, such as "utf-8".  The default is "iso-8859-1".

       -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.   See
              also the options -l and -L.

       -q quality
              Specify  the JPEG compression quality (quantization factor) as a
              number between 1 and 100.  The default is 75.

       -d     Omit the image timestamps from the HTML output.

       -l ../path
              Generate output in a separate directory tree, and generate  sym-
              bolic  links to the source files at ../path.  The input for each
              directory  argument  passed  to  photomolo  will  be  read  from
              ../path/directory.   For  instance, if the full-sized images are
              located at ~/store/pics and the current directory is ~/html, you
              might  want  to  specify  the  arguments -l ../store pics.  This
              option is not available on Windows.

       -L ../path
              Generate output in a separate directory tree, and generate  hard
              links to the source files at ../path.  This option is not avail-
              able on Windows.

       -P command
              Output progress indication to the standard input of an  external
              command  that  is  invoked  by popen(3) as a child process.  The
              progress is indicated by a stream  of  integer  decimal  numbers
              between  0  and  100.   A  possible  command  could  be  "dialog
              --progress".   See  also   dialog(1),   gdialog(1),   and   zen-
              ity(1).Thisoptionis not available on Windows.

       -J command
              Try  to  convert  other than JPEG files to JPEG by invoking sys-
              tem(3) on command.  The names of the input and the output  image
              files  will  be assigned to the environment variables IMG_IN and
              IMG_OUT, respectively.  This option is best used  together  with
              -l, -L, or -t.

EXAMPLES
       The  command  photomolo  -T .8/s8 -T .120/h120 -T .240/h240 images tra-
       verses 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.

       The command photomolo -J raw2jpg -l ../orig -T  .120/h120  images  tra-
       verses  the directory tree ../orig/images containing the original full-
       resolution images and generates the directory  tree  images  containing
       thumbnail  images and HTML navigation, and symbolic links to the origi-
       nal images.

       For future reference, you may want to write the photomolo command in  a
       shell  script  or a batch file.  Starting with version 1.2.3, photomolo
       dumps the command line arguments to each generated HTML document.

       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 detecting the  character  encoding  in  image
       comments.   Sorting criteria cannot be specified either.  The files and
       directories are sorted according to image time stamps.

       All image comments must be in a character encoding that is supported by
       HTML  4.01.   A  conversion  can  be  implemented  with  jpegcom(1) and
       recode(1) like this: jpegcom *.jpg | recode iso-8859-1..utf-8 | jpegcom

       The progress indicator (-P) will not increase monotonically if multiple
       directory arguments are specified.

AUTHOR
       Marko Mkel <marko.makela@iki.fi>.  The image  scaling  algorithm  has
       been adapted from pnmscale(1) by Jef Poskanzer, and the JPEG decompres-
       sion and compression algorithms are in  libjpeg  from  the  Independent
       JPEG Group.

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



                               February 20, 2006                  PHOTOMOLO(1)
