Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
xfce:tumbler:available_plugins [2022/01/02 07:15] – [Customized Thumbnailer for .dds files] gael | xfce:tumbler:available_plugins [2023/06/25 16:12] – [Customized Thumbnailer for folders] fixed path to executable toz | ||
---|---|---|---|
Line 12: | Line 12: | ||
* **[[# | * **[[# | ||
* **[[# | * **[[# | ||
+ | * **[[# | ||
---- | ---- | ||
Line 66: | 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, '' | ! 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, '' | ||
Line 72: | 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, '' | ! 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 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 '' | 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 ==== | ||
Line 111: | 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 127: | Line 133: | ||
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 /usr/ | + | 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 | ||
</ | </ | ||