Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

projects:thunar-plugins:thunar-thumbnailers [2010/04/06 01:40] (current)
Line 1: Line 1:
 +====== thunar-thumbnailers ======
  
 +
 +
 +===== About =====
 +
 +Thunar uses external utilities - so called thumbnailers - to generate previews of certain files. Thunar ships with thumbnailers to generate previews of image and font files and can automatically use available GNOME thumbnailers if it was build with support for gconf.
 +
 +However, even then, there are several file types for which no thumbnailer exists. The thunar-thumbnailers project provides additional thumbnailers for Thunar, that also cover less common file formats. ​
 +\\ 
 +\\
 +[[http://​brainstorm.ubuntu.com/​idea/​6878/​|{{ http://​brainstorm.ubuntu.com/​item/​6878/​image/​1/​index.png }}]]
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +===== Supported Formats =====
 +Thunar-thumnbnailers generates thumbnails for the following formats:
 +
 +\\ 
 +    * EPS
 +    * Postscript
 +    * PDF
 +    * DVI
 +    * OpenDocument Format
 +    * SVGZ (compressed SVG)
 +    * Fig (.fig)
 +    * LaTeX (requires [[http://​tug.org/​teTeX/​|tetex]])
 +    * Raw Digital Camera Images (requires [[http://​code.google.com/​p/​raw-thumbnailer/​|raw-thumbnailer]] and/or [[http://​cybercom.net/​~dcoffin/​dcraw/​|dcraw]])
 +    * Grace (requires [[http://​plasma-gate.weizmann.ac.il/​Grace/​|grace]])
 +    * Video files (requires [[http://​code.google.com/​p/​ffmpegthumbnailer/​|ffmpegthumbnailer]])
 +    * XCF Images (The GIMP's native format)
 +    * Photoshop (PSD) images ​
 +\\
 +And in the near future, hopefully:
 +
 +\\
 +    * AVCHD video files (.MTS extension)
 +    * Audio files ([[http://​code.google.com/​p/​audiothumbnailer/​|audiothumbnailer]])
 +    * RealMedia video files (in ffmpeg 0.5!!!)
 +    * OpenEXR
 +    * Abiword'​s supported files
 +    * Digital Comic (CBZ, CBR)
 +    * Gnuplot batch files (.gnuplot)
 +
 +\\
 +If you have suggestions for more formats you would like to see thumbnails for in Thunar please contact [[erlend.davidson@gmail.com|Erlend Davidson]].
 +
 +
 +
 +
 +===== Screenshots =====
 +{{:​projects:​thunar-plugins:​thunar-thumbnailers-2.png|:​projects:​thunar-plugins:​thunar-thumbnailers-2.png}}
 +
 +
 +
 +
 +
 +===== Releases =====
 +
 +
 +==== Version 0.4.1 ====
 +
 +[[http://​goodies.xfce.org/​releases/​thunar-thumbnailers/​thunar-thumbnailers-0.4.1.tar.bz2|thunar-thumbnailers-0.4.1.tar.bz2]]
 +
 +[[http://​goodies.xfce.org/​releases/​thunar-thumbnailers/​ChangeLog|ChangeLog]]
 +
 +==== Version 0.3.2 ====
 +
 +[[http://​goodies.xfce.org/​releases/​thunar-thumbnailers/​thunar-thumbnailers-0.3.2.tar.bz2|thunar-thumbnailers-0.3.2.tar.bz2]]
 +
 +[[http://​goodies.xfce.org/​releases/​thunar-thumbnailers/​ChangeLog|ChangeLog]]
 +
 +
 +
 +
 +
 +==== Version 0.2.2 ====
 +
 +[[http://​goodies.xfce.org/​releases/​thunar-thumbnailers/​thunar-thumbnailers-0.2.2.tar.bz2|thunar-thumbnailers-0.2.2.tar.bz2]]
 +
 +[[http://​goodies.xfce.org/​releases/​thunar-thumbnailers/​ChangeLog|ChangeLog]]
 +
 +
 +==== Version 0.1.2 ====
 +
 +[[http://​goodies.xfce.org/​releases/​thunar-thumbnailers/​thunar-thumbnailers-0.1.2.tar.bz2|thunar-thumbnailers-0.1.2.tar.bz2]]
 +
 +[[http://​goodies.xfce.org/​releases/​thunar-thumbnailers/​ChangeLog|ChangeLog]]
 +
 +
 +
 +
 +===== Dependencies =====
 +
 +  * Thunar-thumbnailers depends on [[http://​www.imagemagick.org/​script/​index.php|ImageMagick]].
 +
 +\\
 +Some individual thumbnailers have their own additional dependencies in order to function. ​ These are listed in [[thunar-thumbnailers#​Supported Formats|Supported Formats]].
 +
 +\\
 +  * Only versions of Thunar >= 0.8.0 support thunar-thumbnailers.
 +
 +
 +===== Building and Installing =====
 +
 +
 +==== From Source Tarball ====
 +
 +  * After downloading the release tarball (above), extract it to a new directory and run:
 +
 +  ./configure
 +
 +you can add the --enable-tex --enable-grace and --enable-raw options to enable LaTeX, xmgrace and Raw image thumbnailing if desired.
 +
 +\\
 +  * Now type (as //root//):
 +
 +  make && make install
 +
 +  * After installing it is necessary to run
 +
 +  /​usr/​libexec/​thunar-vfs-update-thumbnailers-cache-1
 +
 +as a //user// to regenerate the cache of thumbnailers.
 +
 +You can check which thumbnailers have been recognised by Thunar, by searching the (binary) file, for example:
 +
 +  less ${HOME}/​.cache/​Thunar/​thumbnailers.cache
 +
 +
 +
 +==== From SVN ====
 +To install thunar-thumbnailers from the Subversion Repository you will need the xfce-dev-tools,​ which you can get from [[http://​foo-projects.org/​~benny/​projects/​xfce4-dev-tools/​index.html|here]].
 +
 +You will also need a [[http://​subversion.tigris.org/​|Subversion]] client.
 +\\
 +\\
 +
 +
 +  * Download the current source from SVN into a directory "​thunar-thumbnailers":​
 +
 +  svn co http://​svn.xfce.org/​svn/​goodies/​thunar-thumbnailers/​trunk/​ thunar-thumbnailers
 +
 +  * Then from this directory run:
 +
 +  ./​autogen.sh
 +  make
 +
 +  * Finally (to copy the files to their install locations) as //root// run:
 +
 +  make install
 +
 +  * After installing you should run:
 +
 +  /​usr/​libexec/​thunar-vfs-update-thumbnailers-cache-1
 +
 +to register the new thumbnailers with Thunar.
 +
 +\\
 +
 +You can also browse the SVN repository using the [[http://​svn.xfce.org/​index.cgi/​xfce-goodies/​browse/​thunar-thumbnailers/​trunk|web interface]].
 +
 +
 +
 +===== Technical Details =====
 +
 +  * Thunar is capable of thumbnailing some files itself, and other files if certain programs exist on the system. ​ By itself thunar can handle the following types:
 +    * Image files using Gdk Pixbuf
 +    * JPEG (by extracting thumbnail from the exif data - fast)
 +    * Fonts files (builtin)
 +    * OpenDocument Format files, by extracting thumbnail
 +  * with help from programs:
 +    * PDF (using evince)
 +    * video files (using totem)
 +\\
 +  * Most of the thumbnailers depend on ImageMagick,​ due to the "​convert"​ command.
 +
 +  * Video files:
 +    * Thunar-thumbnailers uses ffmpeg-thumbnailer to generate thumbnails of videos, and so supports all formats ffmpeg does.  This means it does not currently support Real Media video files.
 +
 +
 +
 +
 +===== TODO =====
 +
 +  * MS Office Word documents (perhaps abiword?)
 +
 +===== Reporting Bugs =====
 +
 +Bugs should be reported to the [[http://​bugzilla.xfce.org|Xfce bug tracking system]] (product ''​Thunar Plugins'',​ component ''​thunar-thumbnailers''​).
 +
 +===== Contributing New Thumbnailers =====
 +
 +It is not difficult to write thumbnailers for file formats you use.  You can read the [[http://​thunar.xfce.org/​documentation/​C/​customizing-thunar.html#​thumbnailers|Thunar Documentation - Thumbnailers]] to learn about this.