The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

dthumb - Generate Thumbnails + Index for a set of images

SYNOPSIS

dthumb [options]

VERSION

This manual documents dthumb version 0.2

DESCRIPTION

dthumb will create an index.xhtml with a list (thumbnails) of all images found in the current directory; the thumbnails will link to the images.

It uses a javascript lightbox (see <http://www.huddletogether.com/projects/lightbox/>) to display the images. To view them without the lightbox, either disable it using the -L option or open images by clicking on the filename instead of the thumbnail.

Note that recursion is not yet supported.

During operation, dthumb will show its progress on STDERR.

OPTIONS

-L, --no-lightbox

Disable Javascript lightbox. Note that in the current implementations, this simple skips installation of the data files. The lightbox link in the HTML will still be written, leading to 404s on the server. This will be fixed.

-n, --no-names

Do not show image names below thumbnails

-r, --recreate

Recreate all thumbnails

-d, --size pixels

Maximum thumbnail size (either width or height). Defaults to 200

-s, --spacing float

Use float as spacing factor. The size of each image element (image + possible border around it) is the number of pixels (see --size) times float. So for 1.1 you have a small border around each image, for 1.0 you have no border at all, etc.

Defaults to 1.1

-t, --title string

Set HTML document title. Defaults to the basename of the current directory

-q, --quality int

Set thumbnail quality. Accepts values between 0 and 100, where 100 is the highest possible quality. Default is 75

EXIT STATUS

Zero upon success, non-zero otherwise.

CONFIGURATION

None.

FILES

dthumb always works in the current working directory. It will create the file index.xhtml, in which the HTML code for the thumbnail list is saved.

It also creates two directories: .thumbs for the thumbnail images, and .dthumb, which contains various data (so far icons and javascript code).

DEPENDENCIES

  • autodie (Included in core as of perl 5.10.1)

  • Data::Section

  • Image::Imlib2

  • Time::Progress

BUGS AND LIMITATIONS

Report issues either by mail to <derf@chaosdorf.de> or on <http://github.com/derf/dthumb/issues>.

AUTHOR

Copyright (C) 2009-2011 by Daniel Friesel <derf@chaosdorf.de>.

The lightbox code is (C) by Lokesh Dhakar <http://www.huddletogether.com/projects/lightbox/>.

LICENSE

    0. You just DO WHAT THE FUCK YOU WANT TO