Description

This package Thumbnailer' comes with a library called thumbnailer' and a program called `thumbnailer'.

The thumbnailer library uses external thumbnailing programs to create an image of wanted size from a given file. Supported output formats are PNG and JPEG.

As my own use for the thumbnailer is as a source of mipmapped textures, the default behaviour is to create a full-size thumbnail. E.g. if you have a 3039x2014 camera raw, you'll get a 3039x2014 jpeg or png out. For PDFs and videos, the default size is 2048px on the longest side.

Usage

create a full-size jpeg thumbnail

$ thumbnailer foo.png foo.jpg $ thumbnailer bar.avi foo.jpg

create a png thumbnail that's scaled to fit in a 1024x1024 square

$ thumbnailer -s 1024 foo.pdf foo_thumb.png

irb> require 'thumbnailer'

fit the jpg inside a 256x256 square

irb> Thumbnailer.thumbnail("foo.png", "foo_thumb.jpg", 256)

page five of the pdf

irb> Thumbnailer.thumbnail("bar.pdf", "bar_thumb.png", 2048, 5)

take the main thumbnail at 30 seconds into the video

irb> Thumbnailer.thumbnail("qux.avi", "qux_thumb.jpg", 1024, 30)

List of supported formats

Images Most image formats. PSDs probably not too accurately.

Successfully tested:
  jpg, png, gif, svg,
  orf, nef, dng, crw, arw, raf, pef, cr2,
  tif, xpm, ppm, tga, pcx, bmp,
  psd

Uses image icon:
  xcf

Uses default icon:
  ai, exr

Videos Anything mplayer / ffmpeg can play.

Successfully tested:
  mkv, flv, avi, mpg, mov, wmv, ogg

Audio Anything mplayer can play.

The audio thumbnailing system is a wee bit peculiar. It relies
on a Tcl/Tk app to create a waveform and spectrogram of the audio.

Successfully tested:
  mp3, wav, m4a, flac, ra, ogg, wma

Uses audio icon:
  ape

Documents The document thumbnailer first converts the document into a PDF, then thumbnails the PDF. The PDF conversion requires ooffice for office documents.

The HTML thumbnailer uses GtkMozEmbed.

Successfully tested:
  pdf, html, ps, ps.gz, txt, sxi, odp, ppt, doc, xls

Uses default icon:
  chm
  

Others Thumbnailer uses a mimetype-specific icon from its icons-directory. If there's an SVG icon, the SVG icon will be used. Otherwise a PNG icon will be used.

Successfully tested:
  directory, bz2, rar, tar.gz, ttf

Uses default icon:
  sis, torrent, rb

Requirements

• Ruby 1.8

• Metadata library for Ruby http://github.com/kig/metadata/tree/master

• Tons of image converter programs and shared-mime-info. http://freedesktop.org/wiki/Software/shared-mime-info List of debian packages: inkscape xvfb openoffice.org python-uno libimlib2-ruby netpbm paps gs-common imagemagick mplayer ffmpeg libsnack2 poppler-utils (v0.6 or later, http://poppler.freedesktop.org/)

• You need the latest version of dcraw to handle some camera raw images. http://cybercom.net/~dcoffin/dcraw/

• You need unoconv for thumbnailing office documents: http://dag.wieers.com/home-made/unoconv/

Install

De-compress archive and enter its top directory. Then type:

($ su) # ruby setup.rb

These simple step installs this program under the default location of Ruby libraries. You can also install files into your favorite directory by supplying setup.rb some options. Try "ruby setup.rb --help".

License

GPL v3

Ilmari Heikkinen <ilmari.heikkinen gmail com>