Xfce Wiki

Sub domains
 

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
xfce:tumbler:available_plugins [2022/04/01 13:05] – [Tumbler - Available Plugins] gaelxfce:tumbler:available_plugins [2025/07/30 10:15] (current) – [Cover Thumbnailer] Fix broken link gael
Line 1: Line 1:
 ~~NOTOC~~ ~~NOTOC~~
-{{ :xfce:xfce.tumbler.png?no link|}}+{{ :xfce:tumbler.png?48nolink|}}
 ====== Tumbler - Available Plugins ====== ====== Tumbler - Available Plugins ======
 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.  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. 
Line 67: Line 67:
 ! Disable the plugin, the values ''true'' and ''false'' are accepted. ! Disable the plugin, the values ''true'' and ''false'' are accepted.
 ? Priority ? Priority
-! Numeric value to control the priority of the plugin. If 2 plugins can provide thumbnails for the same scheme + mime-type combination, the plugin with the highest priority is used first.+! Numeric value to control the priority of the plugin. If two plugins can provide thumbnails for the same scheme + mime-type combination, the plugin with the highest priority is used first.
 ? Locations ? 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. ! 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.
Line 73: Line 73:
 ! A ;-separated path list the plugin will not be used for. If the source file is 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 exclude nothing. Please note that paths in ''Excludes'' precede those in ''Locations''. ! A ;-separated path list the plugin will not be used for. If the source file is 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 exclude nothing. Please note that paths in ''Excludes'' precede those in ''Locations''.
 ? MaxFileSize ? 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.+! Maximum size of the source file the plugin will still try to generate a thumbnail for. The size is in bytes, 0 disables the check. 
 + 
 +As of Tumbler 4.17.0 (first stable release 4.18.0), these settings extend to [[#customized_thumbnailers|external thumbnailers]] of the desktop-thumbnailer plugin, by adding the group "X-Tumbler Settings" to the ''.thumbnailer'' files. Further instructions and an example are given at the end of the ''tumbler.rc'' file.
  
 [[|Back to Top]] [[|Back to Top]]
Line 91: Line 93:
   #APIKey=your-api-key-from-themoviedb.org   #APIKey=your-api-key-from-themoviedb.org
  
-The movie thumbnailer supports two different movie APIs. By default, the [[http://omdbapi.com|The Open Movie Database API]] is used. You can also choose to use [[http://themoviedb.org|The Movie DB]], but this site requires an API key which you have to [[http://docs.themoviedb.apiary.io/|request]] or uh... [[https://raw.github.com/xbmc/xbmc/master/addons/metadata.themoviedb.org/tmdb.xml|search]].\\+The movie thumbnailer supports two different movie APIs. By default, the [[http://omdbapi.com|The Open Movie Database API]] is used. You can also choose to use [[http://themoviedb.org|The Movie DB]], but this site requires an API key which you have to [[http://docs.themoviedb.apiary.io/|request]] or uh... [[https://github.com/xbmc/repo-scrapers/blob/11ae1caddd9ca29b5476f645a1d026cdc7088574/metadata.tvshows.themoviedb.org/tmdb.xml|search]].\\
 The advantage of the latter is that their database has better support for internationalized movie names. The advantage of the latter is that their database has better support for internationalized movie names.
  
Line 101: Line 103:
 ===== Customized Thumbnailers ===== ===== 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 ''XDG_DATA_DIRS/thumbnailers'' directories and the ''XDG_DATA_HOME/thumbnailers'' directory (which defaults to ''~/.local/share/thumbnailers''). The former is the place for system wide thumbnailers (normally in ''/usr/share/thumbnailers''), while the latter is the preferred place for the user's customized thumbnailers (see below). 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 ''XDG_DATA_DIRS/thumbnailers'' directories and the ''XDG_DATA_HOME/thumbnailers'' directory (which defaults to ''~/.local/share/thumbnailers''). The former is the place for system wide thumbnailers (normally in ''/usr/share/thumbnailers''), while the latter is the preferred place for the user's customized thumbnailers (see below).
 +
 +Since 4.17.0 (first stable release 4.18.0), in case of several ''.thumbnailer'' files with the same name in the thumbnailer directories, the one placed in the highest priority directory override all the others.
 +
  
 ==== Customized Thumbnailer for .dds files ==== ==== Customized Thumbnailer for .dds files ====
Line 112: Line 117:
 Name=dds Thumbnailer Name=dds Thumbnailer
 MimeType=image/x-dds; MimeType=image/x-dds;
-Exec=/usr/bin/convert -thumbnail %s %i %o+Exec=convert -thumbnail %s %i %o
 </file> </file>
   - 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:<file txt ~/.local/share/mime/packages/dds.xml><?xml version="1.0" encoding="UTF-8"?>   - 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:<file txt ~/.local/share/mime/packages/dds.xml><?xml version="1.0" encoding="UTF-8"?>
Line 135: Line 140:
 Name=Folder Thumbnailer Name=Folder Thumbnailer
 MimeType=inode/directory; MimeType=inode/directory;
-Exec=folder-thumbnailer %s %i %o %u+Exec=sh -c '~/bin/folder-thumbnailer "$@"' _ %s %i %o %u
 </file> </file>
  
Line 159: Line 164:
 Don't forget to give execution permission to the file: Don't forget to give execution permission to the file:
  
-  chmod u+x /usr/bin/folder-thumbnailer+  chmod u+x ~/bin/folder-thumbnailer
      
 and to restart Thunar and Tumbler so that the new folder mime type is taken into account. and to restart Thunar and Tumbler so that the new folder mime type is taken into account.
Line 175: Line 180:
 Name=Text Thumbnailer Name=Text Thumbnailer
 MimeType=text/plain;text/html;text/css; MimeType=text/plain;text/html;text/css;
-Exec=textthumb %s %i %o+Exec=sh -c '~/bin/textthumb "$@"' _ %s %i %o
 </file> </file>
  
Line 212: Line 217:
 Name=webp Thumbnailer Name=webp Thumbnailer
 MimeType=image/webp; MimeType=image/webp;
-Exec=webpthumbs %s %i %o+Exec=sh -c '~/bin/webpthumbs "$@"' _ %s %i %o
 </file> </file>
  
Line 237: Line 242:
 Name=STL Thumbnailer Name=STL Thumbnailer
 MimeType=model/stl; MimeType=model/stl;
-Exec=stl-thumbnailer %i %o %s+Exec=sh -c '~/bin/stl-thumbnailer "$@"' _ %i %o %s
 </file> </file>
  
Line 265: Line 270:
 [[|Back To Top]] [[|Back To Top]]
 ---- ----
-[[:xfce:tumbler:start:|Back to Main Tumbler documentation page]] +[[:xfce:tumbler:start:|Back to Tumbler Main Documentation Page]]
- +
-[[:xfce:thunar:|Back to Thunar documentation page]]+