• ABOUT
• DOWNLOAD
• SYNOPSIS
• OPTIONS
• DESCRIPTION
• PREREQUISITES
• RECENT CHANGES
• Version 1.2
• Version 1.1
• ACKNOWLEDGEMENTS
• Version 1.1
• KNOWN BUGS
• AUTHOR
• COPYRIGHT

ABOUT

I didn't have time to make a detailed page for this script, so this will have to do. This page is essentially the POD output one gets when 'tnailer -h' is run. I'll put up more when I have time. In the meantime, read below for more information.

Basically, this is a script I wrote to automate pulling images off my wife's SmartMedia reader and making web-based galleries out of them. It's a simple script, but a big time-saver (for me, at least) for what it does.

DOWNLOAD

The latest version is 1.2.

You can download tnailer.tar.gz or you can take a look at some examples of it's output here and here.

SYNOPSIS

tnailer [options]

  Options:
    [-h]
    [-c]
    [-s <NN%>]
    [-q <NN>]
    [-d <image source directory>]
    [-o <output directory>]
    [-t <title>]
    [-f]
    [-y]
    [-w <N>]
    [-k <NN%NN%NNN>]

OPTIONS

-h

Prints this help message.

-c

Creates HTML docs with specifically colored background, foreground, table, etc. elements which match 27.org. Takes no arguments.

-s

Reduces originals by specified percentage. Must be of the form ``NN%''. Default is ``50%''

-q

Sets the quality (JPEG/MIFF/PNG compression) level of the resulting images. This must be an integer between 1 and 100, inclusive, with 100 being best quality (and 1 looking like rat doot). This only affects the larger images, whose default is 75; thumbnail images will have a quality level of 25.

-d

The path (either relative or fully qualified) to your source image files. The current working directory is used if not specified.

-o

The path where you'd like the image gallery output put. A subdirectory will be created at this location and the image files and HTML pages will be placed in it. The name of the subdirectory is based on the date and time, so the script can be run more than once (if you're trying out scaling or quality levels or something) without overwriting anything. The current working directory is used if not specified.

-t

The title of album, which will appear on the HTM pages. Enclose this in double quotes if it's longer than one word (to prevent each word being seen as individual optiosn and to escape shell metacharacters). If omitted, the date (which will match your system's ctime() ouput) is used.

-f

Prints a ``Back to gallery'' footer on index page. Probably useful only on 27.org, unless you have a page called 'gallery.html' at the top level of your web root or you change the href. Takes no arguments.

-y

Answers 'Y' to the first prompt. Takes no arguments.

-w

Specifies the number of columns wide for thumbnails. Default is 5.

-k

Default is ``20%40%300'' which means Reduce thumbnails to 20%, but only reduce thumbnails smaller than 300 pixels to 40%.

-x

When enabled, EXIF data (if any is found) for each image will be printed at the bottom of it’s full-size page.

DESCRIPTION

Given a user-definable directory which contains JPEG, PNG, TIFF or (possibly) GIF images, this script creates a series of smaller images, one per html page. It also creates an index.html page for the series, and thumbnails on that which to link to the individual html docs which contain the larger images. Each thumbnail page will have links to the last and next image pages.

A subdirectory will be created at this location and the image files and HTML pages will be placed in it. The name of the subdirectory is based on the date and time, so the script can be run more than once (if you're trying out scaling or quality levels or something) without overwriting anything. The current working directory is used if not specified.

PREREQUISITES

You will need the Image::Magick and Image::Exiftool Perl modules installed for this script to work.

RECENT CHANGES

Version 1.2

• Added option to print EXIF data on image pages (-x switch)
  

Version 1.1

• Made timestamp directory prettier (but still unique)
  
• Added option w to specify the number of columns (default 5)
  
• Added option k to specify reduce percentages
  
• Added option y to answer yes to first prompt
  
• Fixed an off by one error when ``no images processed''
  
• Fixed a regexp error when filename contains more than one dot
  
• Fixed an error where html size tags were wrong if image was too small to be reduced
  
• Running under 'use strict' and with warnings on
  
• Changed how directories are read to allow for better sorting
  
• Fixed bug where empty directories would be created if no images were found
  
• Re-arranged and cleaned up some code (``user'' editable variables now at top as well)
  
• Info messages now sent to STDOUT unbuffered for (maybe) a more responsive feel
  
• Default quality now 75
  

ACKNOWLEDGEMENTS

Version 1.1

Thanks to Jon Gabrielson <jon [AT] directfreight [dot] com> for a lot of the bigger changes.

KNOWN BUGS

I don't know of any bugs in the program, but one current limitation is that there is no consideration given for large image collections. If you have 250 images, then your index page will have 250 thumbnails on it. This might be excessive. I first wrote this script to pull images off a SmartMedia card and make galleries. Since the largest SmartMedia card I have only holds about 80 images, I didn't see the ``one large index page'' thing as being much of an issue. Right now, the only work-around is to break up image collections into useable chunks.

Please report any bugs you find to me at tnailer [AT] 27 [dot] org and I'll try to get them fixed as soon as I can. Also feel free to fix any bugs you find. Send me a patch (or the fixed script) if you do.

AUTHOR

William Rhodes <tnailer [AT] 27 [dot] org>