NAME

dthumb - Generate file index with thumbnails for a directory.

SYNOPSIS

dthumb [-anrR] [-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.

During operation, dthumb will show its progress on STDERR.

OPTIONS

-a, --all

Also include non-image files in the file listing

-n, --no-names

Do not show image names below thumbnails

-r, --recreate

Recreate all thumbnails

-R, --recursive

Include directories in file listing and recurnsively generate thumbnails for their contents.

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

Set maximum thumbnail size. Both width and height will be limited while preserving aspect ratio. Thumbnails are created at 2x resolution and downscaled via HTML tags to accomodate high-DPI displays.

-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

--header file

Include file contents in the generated HTML, right after the opening div tag.

-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