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/01/02 06:43] – [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 12: Line 12:
   * **[[#Customized Thumbnailer for comic book archives|Customized Thumbnailer for comic book archives]]**   * **[[#Customized Thumbnailer for comic book archives|Customized Thumbnailer for comic book archives]]**
   * **[[#Customized Thumbnailer for webp content|Customized Thumbnailer for webp content]]**   * **[[#Customized Thumbnailer for webp content|Customized Thumbnailer for webp content]]**
 +  * **[[#Customized Thumbnailer for stl content|Customized Thumbnailer for stl content]]**
  
 ---- ----
Line 39: Line 40:
      * Thumbnailer for PS/PDF files.      * Thumbnailer for PS/PDF files.
   * __ODF-thumbnailer__   * __ODF-thumbnailer__
-     * Provides thumbnails for different open document types, oasis.opendocument (presentation, text,chart, image), sun.xml ( calc, writer, draw, impress. math) and some more.+     * Provides thumbnails for different open document types, ''oasis.opendocument'' (presentation, text,chart, image), ''sun.xml'' ( calc, writer, draw, impress. math) and some more.
   * __GEpub-thumbnailer__   * __GEpub-thumbnailer__
      * Provides thumbnails for EPUB files.      * Provides thumbnails for EPUB files.
  
 === External Thumbnailers === === External Thumbnailers ===
-  * All thumbnailers provided by .thumbnailer desktop files. [[#customized_thumbnailers|See examples below]].+  * All thumbnailers provided by ''.thumbnailer'' desktop files. Also known as customized or desktop thumbnailers. [[#customized_thumbnailers|See examples below]].
  
  
Line 58: Line 59:
 NB: ''$XDG_CONFIG_HOME'' defaults to ''~/.config''. NB: ''$XDG_CONFIG_HOME'' defaults to ''~/.config''.
  
-  mkdir -p $XDG_CONFIG_HOME/tumbler +  mkdir -p "${XDG_CONFIG_HOME:=~/.config}/tumbler" 
-  cp /etc/xdg/tumbler/tumbler.rc $XDG_CONFIG_HOME/tumbler/+  cp /etc/xdg/tumbler/tumbler.rc "$XDG_CONFIG_HOME/tumbler/"
  
 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: 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:
Line 66: 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. 
 +? Excludes 
 +! 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 88: 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 97: Line 102:
  
 ===== 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 /usr/share/thumbnailers folder.+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 ====
  
-For example, to create a custom thumbnailer for .dds files, do the following: +For example, to create a custom thumbnailer for ''.dds'' files, do the following: 
-  - Create the appropriate .thumbnailer file:<file txt /usr/share/thumbnailers/dds.thumbnailer>+  - Create the appropriate ''.thumbnailer'' file:<file txt ~/.local/share/thumbnailers/dds.thumbnailer>
 [Thumbnailer Entry] [Thumbnailer Entry]
 Version=1.0 Version=1.0
Line 109: 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 119: Line 127:
         <glob pattern="*.dds"/>         <glob pattern="*.dds"/>
     </mime-type>     </mime-type>
-</mime-info></file>...and run "update-mime-database ~/.local/share/mime".+</mime-info></file>...and run<code> 
 +update-mime-database ~/.local/share/mime</code>
  
 ==== Customized Thumbnailer for folders ==== ==== Customized Thumbnailer for folders ====
  
 Another example are albums cover thumbnails for folders in a music collection. A custom thumbnailer can be added to e.g. add a file  ''folder.jpg'' or ''cover.jpg'' into a folder and display its thumbnail instead of the default folder icon: Another example are albums cover thumbnails for folders in a music collection. A custom thumbnailer can be added to e.g. add a file  ''folder.jpg'' or ''cover.jpg'' into a folder and display its thumbnail instead of the default folder icon:
-<file txt /usr/share/thumbnailers/folder.thumbnailer>+<file txt ~/.local/share/thumbnailers/folder.thumbnailer>
 [Thumbnailer Entry] [Thumbnailer Entry]
 Version=1.0 Version=1.0
Line 131: Line 140:
 Name=Folder Thumbnailer Name=Folder Thumbnailer
 MimeType=inode/directory; MimeType=inode/directory;
-Exec=/usr/bin/folder-thumbnailer %s %i %o %u+Exec=sh -c '~/bin/folder-thumbnailer "$@"' _ %s %i %o %u
 </file> </file>
  
-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:+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 /usr/bin/folder-thumbnailer>+<file sh ~/bin/folder-thumbnailer>
 #!/bin/bash #!/bin/bash
  
-convert -thumbnail "$1" "$2/folder.jpg" "$3" 1>/dev/null 2>&1 ||\ +covers=("$2"/{.,}{folder,cover}.{jpg,png}) 
-convert -thumbnail "$1" "$2/.folder.jpg" "$3" 1>/dev/null 2>&1 ||\ +for f in "${covers[@]}"; do 
-convert -thumbnail "$1" "$2/folder.png" "$3" 1>/dev/null 2>&1 ||\ +  [ -f "$f" ] && { 
-convert -thumbnail "$1" "$2/cover.jpg" "$3" 1>/dev/null 2>&1 ||\ +    cover=$f 
-rm -f "$HOME/.cache/thumbnails/normal/$(echo -n "$4" | md5sum | cut -d " " -f1).png" ||\ +    break 
-rm -f "$HOME/.thumbnails/normal/$(echo -n "$4" | md5sum | cut -d " " -f1).png" ||\ +  } 
-rm -f "$HOME/.cache/thumbnails/large/$(echo -n "$4" | md5sum | cut -d " " -f1).png" ||\ +done 
-rm -f "$HOME/.thumbnails/large/$(echo -n "$4" | md5sum | cut -d " " -f1).png" ||\ + 
-exit 1+if [ -z "$cover" ] || ! convert -thumbnail "$1" "$cover" "$3"; then 
 +  gdbus call --session --dest=org.freedesktop.thumbnails.Cache1 --object-path /org/freedesktop/thumbnails/Cache1 \ 
 +             --method org.freedesktop.thumbnails.Cache1.Delete "['$4']" >/dev/null 
 +fi
 </file> </file>
  
-Dont forget to give execution permission to the file! E.g: sudo chmod a+x /usr/bin/folder-thumbnailer+Don't forget to give execution permission to the file: 
 + 
 +  chmod u+x ~/bin/folder-thumbnailer 
 +   
 +and to restart Thunar and Tumbler so that the new folder mime type is taken into account.
  
-Note: imagemagick is a required dependency for this script.+Note: ImageMagick is a required dependency for this script.
  
 ==== Customized Thumbnailer for text-based documents ==== ==== 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:+A thumbnailer for text-based documents can be created using the convert function from the ImageMagick package with the following thumbnailer file:
  
-<file txt /usr/share/thumbnailers/text.thumbnailer>+<file txt ~/.local/share/thumbnailers/text.thumbnailer>
 [Thumbnailer Entry] [Thumbnailer Entry]
 Version=1.0 Version=1.0
Line 164: Line 180:
 Name=Text Thumbnailer Name=Text Thumbnailer
 MimeType=text/plain;text/html;text/css; MimeType=text/plain;text/html;text/css;
-Exec=/usr/local/bin/textthumb %s %i %o+Exec=sh -c '~/bin/textthumb "$@"' _ %s %i %o
 </file> </file>
  
 And supporting script: And supporting script:
  
-<file sh /usr/local/bin/textthumb>+<file sh ~/bin/textthumb>
 #!/bin/bash #!/bin/bash
 +
 iFile=$(<"$2") iFile=$(<"$2")
-iChopped="${iFile:0:1600}" +tempFile=$(mktemp) && { 
-unset iFile +  echo "${iFile:0:1600}" > "$tempFile" 
-echo "${iChopped}" > tmp.txt +  convert -size 210x290 -background white -pointsize 5 -border 10x10 -bordercolor "#CCC" caption:@"$tempFile" "$3" 
-unset iChopped +  rm "$tempFile" 
-convert -size 210x290 -background white -pointsize 5 -border 10x10 -bordercolor "#CCC" caption:@"tmp.txt" "$3" +}
-rm tmp.txt+
 </file> </file>
  
-You can add additional mime types to the MimeType line of the thumbnailer file to support additional text-based document types.+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 ==== ==== 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's repositories). Use the following thumbnailer file: +A thumbnailer for comic book archives (cbr, cbz, cbt, cb7) can be created using the comicthumb utility (search for it your distro's repositories). If not already present as ''/usr/share/thumbnailers/comicthumb.thumbnailer'', create the following thumbnailer file: 
-<file txt /usr/share/thumbnailers/comicthumb.thumbnailer>+<file txt ~/.local/share/thumbnailers/comicthumb.thumbnailer>
 [Thumbnailer Entry] [Thumbnailer Entry]
 TryExec=comicthumb TryExec=comicthumb
Line 192: Line 208:
 </file> </file>
  
-==== Customized Thumbnailer for animated webp content ====+==== Customized Thumbnailer for webp content ====
 Note: Make sure there is an image/webp mimetype defined in your system. Note: Make sure there is an image/webp mimetype defined in your system.
-<file txt /usr/share/thumbnailers/webp.thumbnailer>+<file txt ~/.local/share/thumbnailers/webp.thumbnailer>
 [Thumbnailer Entry] [Thumbnailer Entry]
 Version=1.0 Version=1.0
Line 201: Line 217:
 Name=webp Thumbnailer Name=webp Thumbnailer
 MimeType=image/webp; MimeType=image/webp;
-Exec=/usr/local/bin/webpthumbs %s %i %o+Exec=sh -c '~/bin/webpthumbs "$@"' _ %s %i %o
 </file> </file>
  
 And supporting script: And supporting script:
  
-<file sh /usr/local/bin/textthumb>+<file sh ~/bin/webpthumbs>
 #!/bin/bash #!/bin/bash
  
-/usr/bin/webpmux -get frame 1 "$2" -o /tmp/w.webp > /dev/null 2<&1 +if tempfile=$(mktemp) && /usr/bin/webpmux -get frame 1 "$2" -o "$tempfile"; then 
- +  /usr/bin/convert -thumbnail "$1" "$tempfile" "$3" 
-if [ $? -eq 0 ]; then +
- /usr/bin/convert -thumbnail "$1" "/tmp/w.webp" "$3" +
 else else
- /usr/bin/convert -thumbnail "$1" "$2" "$3"+  /usr/bin/convert -thumbnail "$1" "$2" "$3"
 fi fi
  
-rm /tmp/w.webp+[ -f "$tempfile" ] && rm "$tempfile" 
 +</file> 
 + 
 +==== Customized Thumbnailer for stl content ==== 
 +<file txt ~/.local/share/thumbnailers/stl.thumbnailer> 
 +[Thumbnailer Entry] 
 +Version=1.0 
 +Encoding=UTF-8 
 +Type=X-Thumbnailer 
 +Name=STL Thumbnailer 
 +MimeType=model/stl; 
 +Exec=sh -c '~/bin/stl-thumbnailer "$@"' _ %i %o %s 
 +</file> 
 + 
 +And supporting script: 
 + 
 +<file sh ~/bin/stl-thumbnailer> 
 +#!/bin/bash 
 + 
 +if (($# < 3)); then 
 +  echo "$0: input_file_name output_file_name size" 
 +  exit 1 
 +fi 
 + 
 +INPUT_FILE=$1 
 +OUTPUT_FILE=$2 
 +SIZE=$3 
 + 
 +if TEMP=$(mktemp --directory --tmpdir tumbler-stl-XXXXXX); then 
 +  cp "$INPUT_FILE" "$TEMP/source.stl" 
 +  echo 'import("source.stl", convexity=10);' > "$TEMP/thumbnail.scad" 
 +  openscad --imgsize "500,500" -o "$TEMP/thumbnail.png" "$TEMP/thumbnail.scad" 2>/dev/null 
 +  convert -thumbnail "$SIZE" "$TEMP/thumbnail.png" "$OUTPUT_FILE" &>/dev/null 
 +  rm -rf $TEMP 
 +fi
 </file> </file>
  
 [[|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]]+