Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
xfce:thunar:tumbler [2020/03/11 19:47] – [Customized Thumbnailer for text-based documents] toz | xfce:thunar:tumbler [2020/08/30 09:53] (current) – removed kevinbowen | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== 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 ===== | ||
- | |||
- | Tumbler has since version 0.1.27 a configuration file to control the priority, locations and file sizes the plugin is used for: [[http:// | ||
- | |||
- | To override the default configuration, | ||
- | |||
- | NB: '' | ||
- | |||
- | mkdir -p $XDG_CONFIG_HOME/ | ||
- | cp / | ||
- | |||
- | Each group in the configuration file is responsible for the settings of a particular thumbnailer plugin. The following keys can be used to adjust a plugin: | ||
- | |||
- | ? Disabled | ||
- | ! Disable the plugin, the values '' | ||
- | ? Priority | ||
- | ! Numeric value to control the priority of the plugin. If 2 plugins can provide thumbnails for the same scheme + mime-type combination, | ||
- | ? Locations | ||
- | ! A ;-separated path list the plugin will be used for. If the source file is not a child of one of the locations, the plugin won't be used and another plugin with a lower priority will be tried. Absolute paths, environment variables, ~/ and ~username/ are allowed. Leave empty to allow all locations. | ||
- | ? MaxFileSize | ||
- | ! 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 ===== | ||
- | |||
- | 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 as described above and set the '' | ||
- | |||
- | [CoverThumbnailer] | ||
- | Disabled=false | ||
- | Priority=3 | ||
- | Locations=~/ | ||
- | MaxFileSize=0 | ||
- | # | ||
- | |||
- | The movie thumbnailer supports two different movie APIs. By default, the [[http:// | ||
- | The advantage of the latter is that their database has better support for internationalized movie names. | ||
- | |||
- | 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 / | ||
- | #!/bin/bash | ||
- | |||
- | 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 / | ||
- | #!/bin/bash | ||
- | 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/ | ||
- | </ | ||
- | |||
- | [[|Back To Top]] | ||
- | ---- | ||
- | [[: |