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 [2012/12/12 08:21] – [Cover Thumbnailer] nick | xfce:thunar:tumbler [2019/11/30 00:08] – Added overview on available tumbler plugins 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. | ||
+ | ===== 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. | ||
+ | |||
+ | ===== Available Plugins ===== | ||
+ | === Image Thumbnailers === | ||
+ | * JPEG-thumbnailer | ||
+ | * - Details missing. Please add, if known - | ||
+ | * Is it still thumbnailer needed ? Pixbuf-thumbnailer as well supports jpeg. Is this one 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 | ||
+ | * Download cover from omdbapi.com or themoviedb.org if an API key is given. See details below | ||
+ | * ffmpeg-thumbnailer | ||
+ | * - Details missing. Please add, if known - | ||
+ | * GStreamer-thumbnailer | ||
+ | * - Details missing. Please add, if known - | ||
+ | === Other Thumbnailers === | ||
+ | * Font thumbnailer | ||
+ | * - Details missing. Please add, if known - | ||
+ | * Poppler thumbnailer | ||
+ | * Thumbnailer for PS/PDF files | ||
+ | * Odf thumbnailer | ||
+ | * Open document thumbnailer | ||
+ | * Desktop thumbnailer | ||
+ | * All thumbnailers provided by *.desktop files | ||
===== Cover Thumbnailer ===== | ===== 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. | 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 create a config | + | In order to use the cover thumbnailer you need to copy the tumbler.rc |
- | <file plain ~/ | + | |
- | [General] | + | |
- | # a ; separated list of white-listed locations | + | |
- | Locations=/ | + | |
+ | MaxFileSize=0 | ||
+ | # | ||
- | [TheMovieDB] | + | The movie thumbnailer supports two different movie APIs. By default, the [[http:// |
- | # API key to use themoviedb.org | + | The advantage of the latter is that their database has better support for internationalized movie names. |
- | #API-key=your-private-api-key | + | |
+ | 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 .thumbailer files placed in the / | ||
+ | |||
+ | ==== Customized Thumbnailer for .dds files ==== | ||
+ | |||
+ | For example, to create a custom thumbnailer for .dds files, do the following: | ||
+ | | ||
+ | [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. | ||
- | The cover thumbnailer supports two different API backends: | ||
- | * [[http:// | ||
- | * [[http:// | ||
- | After creating the rc file, it is best if you log-off and on again to restart | + | [[|Back To Top]] |
+ | ---- | ||
+ | [[: |