Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
xfce:thunar:tumbler [2013/01/12 12:08] – [Cover Thumbnailer] nick | xfce:thunar:tumbler [2020/04/09 23:52] – [Customized Thumbnailer for comic book archives] alexxcons | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Tumbler ====== | ====== Tumbler ====== | ||
+ | The Tumbler package contains a D-Bus thumbnailing service based on the thumbnail management D-Bus specification. This is useful for generating thumbnail images of files. | ||
+ | |||
+ | ===== Available Plugins ===== | ||
+ | Tumbler allows to load a number plugins to support different file formats. Most plugins are loaded by default, if the required libraries are provided. | ||
+ | === Image Thumbnailers === | ||
+ | * __JPEG-thumbnailer__ | ||
+ | * - Details missing. Please add, if known - | ||
+ | * Is that plugin still needed ? Pixbuf-thumbnailer as well supports jpeg. Is this plugin faster ? | ||
+ | * __Pixbuf-thumbnailer__ | ||
+ | * Supports all type GdkPixbuf supports (Gtk3.22: ani, bmp, GdkPixdata, gif, icns, ico, jpeg, png, pnm, qtif, svg, tga, tiff, wmf, xbm, xpm) | ||
+ | * __Raw-thumbnailer__ | ||
+ | | ||
+ | === Video Thumbnailers === | ||
+ | * __Cover-thumbnailer__ | ||
+ | * Downloads video covers from omdbapi.com or themoviedb.org. [[xfce: | ||
+ | * __ffmpeg-thumbnailer__ | ||
+ | * - Details missing. Please add, if known - | ||
+ | * Requires package: ?? | ||
+ | * __GStreamer-thumbnailer__ | ||
+ | * Provides video and audio cover (e.g. mp3, flac, etc) thumbnails. | ||
+ | * Requires package: gstreamer1.0-plugins-* (debian), gstreamer1-plugins-* (fedora), gst-plugins-* (Arch) | ||
+ | === Other Thumbnailers === | ||
+ | * __Font-thumbnailer__ | ||
+ | * - Details missing. Please add, if known - | ||
+ | * __Poppler-thumbnailer__ | ||
+ | * Thumbnailer for PS/PDF files | ||
+ | * Requires package: // | ||
+ | * __ODF-thumbnailer__ | ||
+ | * Provides thumbnails for different open document types, oasis.opendocument (presentation, | ||
+ | * Here the [[https:// | ||
+ | * __Customized thumbnailers__ | ||
+ | * All thumbnailers provided by .thumbnailer desktop files. [[xfce: | ||
+ | |||
+ | ---- | ||
===== Configuration ===== | ===== Configuration ===== | ||
- | Tumbler has since version 0.1.27 a configuration file to control the priority | + | Tumbler has since version 0.1.27 a configuration file to control the priority, |
To override the default configuration, | To override the default configuration, | ||
+ | |||
+ | NB: '' | ||
mkdir -p $XDG_CONFIG_HOME/ | mkdir -p $XDG_CONFIG_HOME/ | ||
cp / | cp / | ||
- | Each group in the plugin | + | Each group in the configuration file is responsible for the settings of a particular |
? Disabled | ? Disabled | ||
Line 21: | Line 57: | ||
! Maximum size of the source file the plugin will still try to generate a plugin for. The size is in bytes, 0 disabled the check. | ! Maximum size of the source file the plugin will still try to generate a plugin for. The size is in bytes, 0 disabled the check. | ||
+ | ---- | ||
===== Cover Thumbnailer ===== | ===== Cover Thumbnailer ===== | ||
Line 26: | Line 63: | ||
By the default the cover thumbnailer is disabled. The reason is that it sends information (movie title extracted from the filename) to online services to retrieve a poster. This information is normally harmless, but it is private, so therefore it's not enabled by default. | By the default the cover thumbnailer is disabled. The reason is that it sends information (movie title extracted from the filename) to online services to retrieve a poster. This information is normally harmless, but it is private, so therefore it's not enabled by default. | ||
- | In order to use the cover thumbnailer you need to copy the tumbler.rc file to your home directory | + | In order to use the cover thumbnailer you need to copy the tumbler.rc file to your home directory |
[CoverThumbnailer] | [CoverThumbnailer] | ||
Line 35: | Line 72: | ||
# | # | ||
- | The movie thumbnailer supports | + | The movie thumbnailer supports |
- | Advantage | + | The advantage |
+ | |||
+ | After creating the rc file, it is best to log off and on again to restart Thunar and Tumbler, because both applications cache the mime-type combinations. | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ===== Customized Thumbnailers ===== | ||
+ | As of version 0.2.0, the desktop thumbnailer functionality has been added back into tumbler. This functionality supports custom .thumbnailer files placed in the / | ||
+ | |||
+ | ==== Customized Thumbnailer for .dds files ==== | ||
+ | |||
+ | For example, to create a custom thumbnailer for .dds files, do the following: | ||
+ | - Create the appropriate .thumbnailer file:< | ||
+ | [Thumbnailer Entry] | ||
+ | Version=1.0 | ||
+ | Encoding=UTF-8 | ||
+ | Type=X-Thumbnailer | ||
+ | Name=dds Thumbnailer | ||
+ | MimeType=image/ | ||
+ | Exec=/ | ||
+ | </ | ||
+ | - Ensure that a dds mimetype exists in your system (you can view mimetypes with the Xfce4 Mime Type Editor). If it does not exist, create the necessary mime file:< | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | <icon name=" | ||
+ | < | ||
+ | <glob pattern=" | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | ==== Customized Thumbnailer for folders ==== | ||
+ | |||
+ | Another example are albums cover thumbnails for folders in a music collection. Starting with thunar 1.8.2 a custom thumbnailer can be added to e.g. add a file '' | ||
+ | <file txt / | ||
+ | [Thumbnailer Entry] | ||
+ | Version=1.0 | ||
+ | Encoding=UTF-8 | ||
+ | Type=X-Thumbnailer | ||
+ | Name=Folder Thumbnailer | ||
+ | MimeType=inode/ | ||
+ | Exec=/ | ||
+ | </ | ||
+ | |||
+ | In order to support different names for the picture-file and to remove the thumbnail if not needed any more (display the default folder icon) , a separate script is required: | ||
+ | |||
+ | <file sh / | ||
+ | # | ||
+ | |||
+ | convert -thumbnail " | ||
+ | convert -thumbnail " | ||
+ | convert -thumbnail " | ||
+ | convert -thumbnail " | ||
+ | rm -f " | ||
+ | rm -f " | ||
+ | rm -f " | ||
+ | rm -f " | ||
+ | exit 1 | ||
+ | </ | ||
+ | |||
+ | Dont forget to give execution permission to the file! E.g: sudo chmod a+x / | ||
+ | |||
+ | Note: imagemagick is a required dependency for this script. | ||
+ | |||
+ | ==== Customized Thumbnailer for text-based documents ==== | ||
+ | A thumbnailer for text-based documents can be created using the convert function from the imagemagick package with the following thumbnailer file: | ||
+ | |||
+ | <file txt / | ||
+ | [Thumbnailer Entry] | ||
+ | Version=1.0 | ||
+ | Encoding=UTF-8 | ||
+ | Type=X-Thumbnailer | ||
+ | Name=Text Thumbnailer | ||
+ | MimeType=text/ | ||
+ | Exec=/ | ||
+ | </ | ||
+ | |||
+ | And supporting script: | ||
+ | |||
+ | <file sh / | ||
+ | # | ||
+ | iFile=$(<" | ||
+ | iChopped=" | ||
+ | unset iFile | ||
+ | echo " | ||
+ | unset iChopped | ||
+ | convert -size 210x290 -background white -pointsize 5 -border 10x10 -bordercolor "# | ||
+ | rm tmp.txt | ||
+ | </ | ||
+ | |||
+ | You can add additional mime types to the MimeType line of the thumbnailer file to support additional text-based document types. | ||
+ | |||
+ | ==== Customized Thumbnailer for comic book archives ==== | ||
+ | A thumbnailer for comic book archives (cbr, cbz, cbt, cb7) can be created using the comicthumb utility (search for it your distro' | ||
+ | <file txt / | ||
+ | [Thumbnailer Entry] | ||
+ | TryExec=comicthumb | ||
+ | Exec=comicthumb %u %o %s | ||
+ | MimeType=application/ | ||
+ | application/ | ||
+ | </ | ||
+ | |||
+ | ==== Customized Thumbnailer for webp content ==== | ||
+ | Note: Make sure there is an image/webp mimetype defined in your system. | ||
+ | <file txt / | ||
+ | [Thumbnailer Entry] | ||
+ | Version=1.0 | ||
+ | Encoding=UTF-8 | ||
+ | Type=X-Thumbnailer | ||
+ | Name=webp Thumbnailer | ||
+ | MimeType=image/ | ||
+ | Exec=/ | ||
+ | </ | ||
- | After creating the rc file, it is best if you log-off and on again to restart | + | [[|Back To Top]] |
+ | ---- | ||
+ | [[: |