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/11 22:15] – [Cover Thumbnailer] nick | xfce:thunar:tumbler [2018/08/25 00:15] – [Customized Thumbnailer for folders] toz | ||
---|---|---|---|
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. | ||
===== 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=" | ||
+ | </ | ||
+ | </ | ||
- | The cover thumbnailer supports two different API backends: | + | ==== Customized Thumbnailer for folders ==== |
- | * [[http:// | + | |
- | * [[http:// | + | |
- | After creating | + | 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 | ||
+ | |||
+ | <file sh / | ||
+ | # | ||
+ | |||
+ | convert -thumbnail " | ||
+ | convert -thumbnail " | ||
+ | convert -thumbnail " | ||
+ | convert -thumbnail " | ||
+ | rm -f " | ||
+ | rm -f " | ||
+ | rm -f " | ||
+ | rm -f " | ||
+ | exit 0 | ||
+ | </ |