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:tumbler:available_plugins [2022/01/02 06:19] – [Available Plugins] gael | xfce:tumbler:available_plugins [2022/12/05 15:29] – [Customized Thumbnailers] Update 4.18 gael | ||
---|---|---|---|
Line 12: | Line 12: | ||
* **[[# | * **[[# | ||
* **[[# | * **[[# | ||
+ | * **[[# | ||
---- | ---- | ||
Line 19: | Line 20: | ||
=== Image Thumbnailers === | === Image Thumbnailers === | ||
* __JPEG-thumbnailer__ | * __JPEG-thumbnailer__ | ||
- | | + | |
- | * Is that plugin still needed ? Pixbuf-thumbnailer as well supports jpeg. Is this plugin faster ? | + | |
* __Pixbuf-thumbnailer__ | * __Pixbuf-thumbnailer__ | ||
- | * Supports all type GdkPixbuf | + | * Supports all type gdk-pixbuf |
+ | sed -n ' | ||
+ | </ | ||
* __Raw-thumbnailer__ | * __Raw-thumbnailer__ | ||
- | | + | |
=== Video Thumbnailers === | === Video Thumbnailers === | ||
* __Cover-thumbnailer__ | * __Cover-thumbnailer__ | ||
* Downloads video covers from omdbapi.com or themoviedb.org. [[# | * Downloads video covers from omdbapi.com or themoviedb.org. [[# | ||
* __ffmpeg-thumbnailer__ | * __ffmpeg-thumbnailer__ | ||
- | | + | |
- | * Requires package: libffmpegthumbnailer4v5 | + | |
* __GStreamer-thumbnailer__ | * __GStreamer-thumbnailer__ | ||
* Provides video and audio cover (e.g. mp3, flac, etc) thumbnails. | * Provides video and audio cover (e.g. mp3, flac, etc) thumbnails. | ||
- | * Requires package: gstreamer1.0-plugins-* (debian), gstreamer1-plugins-* (fedora), gst-plugins-* (Arch) | + | === Document |
- | === Other Thumbnailers === | + | |
* __Font-thumbnailer__ | * __Font-thumbnailer__ | ||
- | | + | |
* __Poppler-thumbnailer__ | * __Poppler-thumbnailer__ | ||
- | * Thumbnailer for PS/PDF files | + | * Thumbnailer for PS/PDF files. |
- | * Requires package: // | + | |
* __ODF-thumbnailer__ | * __ODF-thumbnailer__ | ||
- | * Provides thumbnails for different open document types, oasis.opendocument (presentation, | + | * Provides thumbnails for different open document types, |
- | * Here the [[https:// | + | |
* __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. [[# | + | * All thumbnailers provided by '' |
Line 61: | Line 59: | ||
NB: '' | NB: '' | ||
- | mkdir -p $XDG_CONFIG_HOME/ | + | mkdir -p "${XDG_CONFIG_HOME: |
- | cp / | + | 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: | 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 69: | Line 67: | ||
! Disable the plugin, the values '' | ! Disable the plugin, the values '' | ||
? Priority | ? Priority | ||
- | ! Numeric value to control the priority of the plugin. If 2 plugins can provide thumbnails for the same scheme + mime-type combination, | + | ! Numeric value to control the priority of the plugin. If two plugins can provide thumbnails for the same scheme + mime-type combination, |
? 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, |
+ | ? 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, '' | ||
? MaxFileSize | ? MaxFileSize | ||
- | ! Maximum size of the source file the plugin will still try to generate a plugin | + | ! Maximum size of the source file the plugin will still try to generate a thumbnail |
+ | |||
+ | As of Tumbler 4.17.0 (first stable release 4.18.0), these settings extend to [[# | ||
[[|Back to Top]] | [[|Back to Top]] | ||
Line 100: | 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 / | + | As of version 0.2.0, the desktop thumbnailer functionality has been added back into tumbler. This functionality supports custom |
+ | |||
+ | Since 4.17.0 (first stable release 4.18.0), in case of several '' | ||
==== 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 '' |
- | - Create the appropriate .thumbnailer file:< | + | - Create the appropriate |
[Thumbnailer Entry] | [Thumbnailer Entry] | ||
Version=1.0 | Version=1.0 | ||
Line 112: | Line 117: | ||
Name=dds Thumbnailer | Name=dds Thumbnailer | ||
MimeType=image/ | MimeType=image/ | ||
- | Exec=/usr/bin/convert -thumbnail %s %i %o | + | Exec=convert -thumbnail %s %i %o |
</ | </ | ||
- 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:< | - 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:< | ||
Line 122: | Line 127: | ||
<glob pattern=" | <glob pattern=" | ||
</ | </ | ||
- | </ | + | </ |
+ | update-mime-database ~/ | ||
==== 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 '' | Another example are albums cover thumbnails for folders in a music collection. A custom thumbnailer can be added to e.g. add a file '' | ||
- | <file txt /usr/ | + | <file txt ~/.local/ |
[Thumbnailer Entry] | [Thumbnailer Entry] | ||
Version=1.0 | Version=1.0 | ||
Line 134: | Line 140: | ||
Name=Folder Thumbnailer | Name=Folder Thumbnailer | ||
MimeType=inode/ | MimeType=inode/ | ||
- | Exec=/usr/ | + | Exec=sh -c '~/ |
</ | </ | ||
- | 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/ | + | <file sh ~/ |
#!/bin/bash | #!/bin/bash | ||
- | convert -thumbnail | + | covers=("$2"/{.,}{folder,cover}.{jpg,png}) |
- | convert | + | for f in "${covers[@]}"; do |
- | convert | + | |
- | convert -thumbnail " | + | cover=$f |
- | rm -f " | + | break |
- | rm -f " | + | } |
- | rm -f "$HOME/.cache/ | + | done |
- | rm -f " | + | |
- | exit 1 | + | if [ -z "$cover" |
+ | gdbus call --session | ||
+ | | ||
+ | fi | ||
</ | </ | ||
- | Dont forget to give execution permission to the file! E.g: sudo chmod a+x / | + | Don' |
+ | |||
+ | | ||
+ | |||
+ | and to restart Thunar and Tumbler so that the new folder mime type is taken into account. | ||
- | Note: imagemagick | + | Note: ImageMagick |
==== 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 | + | A thumbnailer for text-based documents can be created using the convert function from the ImageMagick |
- | <file txt /usr/ | + | <file txt ~/.local/ |
[Thumbnailer Entry] | [Thumbnailer Entry] | ||
Version=1.0 | Version=1.0 | ||
Line 167: | Line 180: | ||
Name=Text Thumbnailer | Name=Text Thumbnailer | ||
MimeType=text/ | MimeType=text/ | ||
- | Exec=/usr/local/ | + | Exec=sh -c '~/ |
</ | </ | ||
And supporting script: | And supporting script: | ||
- | <file sh /usr/local/ | + | <file sh ~/ |
#!/bin/bash | #!/bin/bash | ||
+ | |||
iFile=$(<" | iFile=$(<" | ||
- | iChopped=" | + | tempFile=$(mktemp) && { |
- | unset iFile | + | echo " |
- | echo "${iChopped}" | + | convert -size 210x290 -background white -pointsize 5 -border 10x10 -bordercolor "# |
- | unset iChopped | + | rm " |
- | 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. | + | You can add additional mime types to the '' |
==== 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' | + | A thumbnailer for comic book archives (cbr, cbz, cbt, cb7) can be created using the comicthumb utility (search for it your distro' |
- | <file txt /usr/ | + | <file txt ~/.local/ |
[Thumbnailer Entry] | [Thumbnailer Entry] | ||
TryExec=comicthumb | TryExec=comicthumb | ||
Line 195: | Line 208: | ||
</ | </ | ||
- | ==== Customized Thumbnailer for animated | + | ==== 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/ | + | <file txt ~/.local/ |
[Thumbnailer Entry] | [Thumbnailer Entry] | ||
Version=1.0 | Version=1.0 | ||
Line 204: | Line 217: | ||
Name=webp Thumbnailer | Name=webp Thumbnailer | ||
MimeType=image/ | MimeType=image/ | ||
- | Exec=/usr/local/ | + | Exec=sh -c '~/ |
</ | </ | ||
And supporting script: | And supporting script: | ||
- | <file sh /usr/local/bin/textthumb> | + | <file sh ~/bin/webpthumbs> |
#!/bin/bash | #!/bin/bash | ||
- | / | + | if tempfile=$(mktemp) && |
- | + | / | |
- | if [ $? -eq 0 ]; then | + | |
- | / | + | |
else | else | ||
- | / | + | |
fi | fi | ||
- | rm /tmp/w.webp | + | [ -f " |
+ | </file> | ||
+ | |||
+ | ==== Customized Thumbnailer for stl content ==== | ||
+ | <file txt ~/.local/ | ||
+ | [Thumbnailer Entry] | ||
+ | Version=1.0 | ||
+ | Encoding=UTF-8 | ||
+ | Type=X-Thumbnailer | ||
+ | Name=STL Thumbnailer | ||
+ | MimeType=model/ | ||
+ | Exec=sh -c ' | ||
+ | </ | ||
+ | |||
+ | And supporting script: | ||
+ | |||
+ | <file sh ~/ | ||
+ | # | ||
+ | |||
+ | 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); | ||
+ | cp " | ||
+ | echo ' | ||
+ | openscad --imgsize " | ||
+ | convert -thumbnail " | ||
+ | rm -rf $TEMP | ||
+ | fi | ||
</ | </ | ||