NAME

dthumb - Generate file index with thumbnails for a directory.

SYNOPSIS

dthumb [-nr] [-d size] [-s spacing] [-t title] [-q quality]

VERSION

version 0.2

DESCRIPTION

dthumb creates an HTML index with thumbnails for all images found in the current directory. It uses a javascript lightbox (see http://fancyapps.com/fancybox/) to display images. To view them without the lightbox, 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

-n, --no-names

Do not show image names below thumbnails

-r, --recreate

Recreate all thumbnails

-d, --size maxsize (default: 200)

Set maximum thumbnail size. Thumbnails are created so that neither width nor height exceed maxsize pixels.

-s, --spacing float (default: 1.1)

Use float as spacing factor. The size of each image element (image + 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.

-t, --title string

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

-q, --quality int (default: 75)

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

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.html, in which the HTML code for the thumbnail list is saved.

It also creates two directories: .thumbs for the thumbnail images, and .dthumb for CSS and lightbox 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-2016 by Daniel Friesel <derf@chaosdorf.de>.

The lightbox code is (C) by J0101nis Skarnelis under the license CC-BY-NC 3.0. See http://fancyapps.com/fancybox/.

LICENSE

For this program:

    0. You just DO WHAT THE FUCK YOU WANT TO

For the lightbox code (part of the generated HTML):

    CC-BY-NC 3.0