Asp Forum - [ANN] Thumbnailer 0.1

Ilmari Heikkinen

9/22/2007 11:09:00 AM

tarball: http://dark.fhtr.org/repos/t.../thumbnailer-...
git: http://dark.fhtr.org/repos/t...

example thumbnails: http://dark.fhtr.org/repos/t.../example_thumbnails/

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, psd, orf, nef, dng, crw, pef, tif, xpm, ppm, tga, svg

Uses image icon:
xcf

Videos
Anything mplayer / ffmpeg can play.

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

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.
And that requires an X server, of which Xvfb is the best for this
purpose. See Requirements.

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, which requires an X server. So it
uses yet another Xvfb server for it. See Requirements.

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

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, torrent

Requirements
------------

* Ruby 1.8

* Metadata library for Ruby
http://dark.fhtr.org/repo...

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

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

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

* For HTML thumbnailing, you need an X server on display :15
- with Xvfb: Xvfb -ac -screen 0 1024x1024x24 :15

* For audio thumbnailing, you need an X server on display :16
- with Xvfb: Xvfb -ac -screen 0 514x514x24 :16

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>
http://fhtr.bl...

comp.lang.ruby

[ANN] Thumbnailer 0.1

Ilmari Heikkinen

x Login to ForumsZone