Nautilus (GNOME Files) 和基于 Nautilus 的文件管理器（即 Nemo 和 Caja）已经使用其默认缩略图为许多常见文件类型创建了预览。此外还有许多其他缩略图制作者可以从官方存储库安装，以便为更多文件创建缩略图。但是，自然存在某些类型的文件不存在缩略图。我遇到的一些此类类型的示例是 WebP、PSD、JP2、APK 等。
我需要知道什么或采取什么步骤来创建可供 Nautilus、Nemo 或 Caja 使用的自定义缩略图来为这些文件类型生成缩略图？
答案1
参考
以下部分提供了有关缩略图制作过程也创建自定义缩略图的步骤对于上述文档中未提及的 Nautilus、Nemo 和 Caja。
应当指出的是鹦鹉螺指的是 Nautilus 的最新版本，它实现了缩略图沙盒在 Ubuntu 上，它们是使用libgnome-desktop 3.28.2或更新版本。
缩略图和缩略图条目
要生成文件的缩略图，需要两个基本的东西：
- A缩略图程序（要不就缩略图）：一种可以以某种方式将文件转换为 PNG 图像的程序，最好带有调整图像大小的选项。一些示例包括、、
convert等。ffmpeggdk-pixbuf-thumbnailer - A缩略图条目
.thumbnailer：扩展名为 或 的~/.local/share/thumbnailers文本文件/usr/share/thumbnailers。此文件将缩略图程序与程序将为其创建缩略图的文件类型联系起来。缩略图程序条目如下所示：[Thumbnailer Entry] TryExec=/usr/bin/gdk-pixbuf-thumbnailer Exec=/usr/bin/gdk-pixbuf-thumbnailer -s %s %i %o MimeType=image/jpeg;image/png;image/gif;image/tiff;
每个缩略图条目位于密钥文件格式支持三个键：
TryExec：（选修的）此键用于检查缩略图程序是否已安装。其值是缩略图程序的路径或可在环境变量中找到的程序名称。如果程序不存在或不可执行，则不会执行键$PATH中的命令。但是，NautilusExec忽略此键并始终尝试执行缩略图程序。Exec：（必需的）生成缩略图时要执行的命令。此命令由缩略图程序的完整路径或其名称（在当前$PATH）后跟空格分隔的参数组成。参数可以是几个特殊参数之一，这些参数在传递给缩略图程序之前会自动替换：%i：（%u若未使用则必填）缩略图文件的完整路径，例如：
无论路径是否包含空格或其他特殊字符，它都会作为单个参数传递给缩略图程序。/home/calico/Pictures/image.jpg /home/calico/Music/Pop Music/audio.mp3%u：（%i若未使用则必填）正在缩略图化文件的 URI。如果缩略图化程序可以处理 URI 语法%u，则应使用 而不是%i。本地文件作为 传递file://<full-path-to-file>，例如：file:///home/calico/Pictures/image.jpg file:///home/calico/Music/Pop%20Music/audio.mp3%o：（必需的）输出缩略图的完整路径。Nautilus、Nemo 和 Caja 分别将输出图像写入：/tmp/gnome-desktop-thumbnailer-XXXXXX/gnome-desktop-thumbnailer.png /tmp/.gnome_desktop_thumbnail.XXXXXX /tmp/.mate_desktop_thumbnail.XXXXXXXXXXXX是一个由大写字母和数字组成的 6 个字符的字符串。每个输出图像文件都被赋予一个唯一的XXXXXX。%s：（选修的）默认缩略图大小（以像素为单位）。如果使用，%s则替换为128（由 Caja 或 Nemo 的旧版本提供）或256（由 Nautilus 或 Nemo 的较新版本提供）。
MimeType：（必需的）这MIME 类型缩略图程序将为其生成缩略图的文件。多个 MIME 类型以分号分隔。请参阅创建自定义缩略图的步骤部分了解有关如何获取每个文件的 mime 类型的详细信息。
密钥注释Exec：
- 一般情况下，命令中只使用
%i或其中一个。%u - 文字百分比字符被转义为
%%（例如50%%使用50%）。 - 看桌面输入规范 - Exec 键更多细节。
让我们以上面的缩略图程序条目为例：gdk-pixbuf-thumbnailer用作 JPEG、PNG、GIF 和 TIFF 图像的缩略图程序。如果我们打开一个文件夹，例如/home/calico/Pictures，其中包含image.gif：
- Nemo（在 Ubuntu 20.04 或更高版本上）将执行以下命令：
/usr/bin/gdk-pixbuf-thumbnailer -s 256 /home/calico/Pictures/image.gif /tmp/.gnome_desktop_thumbnail.1ABC20 - Caja 将执行该命令：
/usr/bin/gdk-pixbuf-thumbnailer -s 128 /home/calico/Pictures/image.gif /tmp/.mate_desktop_thumbnail.DE3450 - Nautilus（
libgnome-desktop3.37.2 或更新版本）将执行以下操作：- 创建临时目录：
/tmp/gnome-desktop-thumbnailer-67FG80。 - 将该目录挂载
/tmp到沙箱中。 image.gif在/tmp/image.gif沙箱中安装。- 执行此命令（在沙箱内）：
/usr/bin/gdk-pixbuf-thumbnailer -s 256 /tmp/image.gif /tmp/gnome-desktop-thumbnailer.png
- 创建临时目录：
缩略图脚本
缩略图条目仅执行一个命令：后面的第一个字符串（与其他字符串以空格分隔）Exec=被视为要执行的程序的名称或路径，并且一切之后的命令被视为要传递给程序的参数。但是，在许多情况下，需要多个命令才能创建合适的缩略图。例如，可以在一个命令中将 WebP 图像转换为 PNG 格式，但它需要其他程序（例如和）dwebp的帮助来计算输出图像的适当宽度和高度。在这种情况下，webpmuxbc缩略图脚本已投入使用。
- A缩略图脚本：包含创建缩略图命令的脚本。它可以是 shell 脚本、Python 脚本等，具体取决于所涉及的文件和程序的类型。Shell 脚本非常常用，它们看起来像这样：
#!/bin/bash in_file="$1" size="$2" out_file="$3" <command> <another-command> <thumbnailer-program> -i "$in_file" -s "$size" -o "$out_file"
脚本可以直接用作要执行的程序，也可以用作包含命令的文本文件。例如：
# a script used as a program
Exec=/home/calico/Documents/example-thumbnailer-script %i %s %o
# a script used as a file containing commands
Exec=bash /home/calico/Documents/example-thumbnailer-script %i %s %o
如果使用了 shell 脚本，则脚本路径后的参数（例如%i、%s和）将分配给脚本中的%o位置参数（$1、$2、等）。$3
看到这个回答和这个文章分别创建 WebP 图片和 APK 文件缩略图的 shell 脚本示例，或此文章有关为 MRC 图像创建缩略图的 Python 脚本示例。
创建自定义缩略图的步骤
查找并安装缩略图程序
找到一个可以将您想要缩略的文件类型转换为 PNG 格式的程序。在安装新程序之前，您可能想尝试预装的缩略图程序：
gdk-pixbuf-thumbnailer：GNOME 和基于 GNOME 的桌面上图像的默认缩略图。totem-video-thumbnailer和ffmpegthumbnailer：分别是 GNOME 和 Cinnamon/MATE 桌面上视频的默认缩略图。evince-thumbnailer、xreader-thumbnailer和atril-thumbnailer：分别是 GNOME、Cinnamon 和 MATE 桌面上 PDF 和其他文档文件的默认缩略图。gnome-thumbnail-font和mate-thumbnail-font：分别是 GNOME/Cinnamon 和 MATE 桌面上字体的默认缩略图。
尝试在终端中手动调用它们，从输入文件创建 PNG 图像。例如：
cd ~/Pictures gdk-pixbuf-thumbnailer -s 256 example.webp out.png ffmpegthumbnailer -s 256 -i example.webp -o out.png如果这些程序无法处理您想要缩略的文件类型，那么是时候寻找新的缩略图程序了。
convert（来自imagemagick）并且ffmpeg通常用于支持多种文件格式。您可以使用以下方式安装它们：sudo apt install imagemagick sudo apt install ffmpeg您还可以选择使用专门处理某些类型文件的程序。例如，
dwebp和opj_decompress分别专门用于解码 WebP 图像和 JPEG-2000 图像。获取MIME 类型要缩略图的文件数
- 右键单击要缩略图的文件类型，选择特性。
- 在基本的选项卡，注意类型字段。MIME 类型显示在括号中。
或者，您可以使用。例如，要获取中
xdg-mime的 mime-type ，请发出以下命令：example.pdf~/Documentsxdg-mime query filetype ~/Documents/example.pdf创建一个缩略图脚本（如有必要）
- 如果需要多个命令或程序来为您的文件生成缩略图，请使用文本编辑器（如
nano或）gedit创建包含这些命令的缩略图脚本。 - 如果您使用 Nemo 或 Caja，则可以将脚本放在主目录中的某个位置。但是，如果您使用 Nautilus，则只能将脚本放在挂载在沙箱（看缩略图问题→由于缩略图程序沙盒化，缩略图显示失败
/usr/local/bin下）。如果您不确定，受到推崇的。 - 如果要将脚本用作程序，则必须使其可执行。例如：
chmod +x /home/calico/Documents/webp-thumbnailer-script sudo chmod +x /usr/local/bin/psd-thumbnailer-script
- 如果需要多个命令或程序来为您的文件生成缩略图，请使用文本编辑器（如
- 创建一个缩略图条目
使用文本编辑器创建缩略图条目（带有
.thumbnailer扩展名的文本文件）。为其指定一个描述性名称，例如webp.thumbnailer或psd.thumbnailer。将缩略图条目放入
~/.local/share/thumbnailers或/usr/share/thumbnailers中，以便当前用户或所有用户分别可以使用。如果您打算将其放入 中/usr/share/thumbnailers，则使用nano创建和编辑条目强力推荐。 例如：sudo nano /usr/share/thumbnailers/webp.thumbnailer至于条目的内容（见缩略图和缩略图条目详情见上文）：
- 该文件的第一行必须是：
[Thumbnailer Entry] TryExec如果您想检查程序或脚本是否存在且可执行，请使用该键。- 在键中指定要执行的程序的名称或路径以及要传递给它的参数
Exec。如果使用缩略图脚本，它必须是程序或参数（请参阅缩略图脚本详情请参见上文。 - 将步骤 2 中找到的 mime 类型放入
MimeType键中。如果此键包含多个 mime 类型，则用分号 (;) 分隔每个类型，并可选择用分号结束键的值。
- 该文件的第一行必须是：
- 清除旧的缓存缩略图并重新启动文件管理器
- 创建新的缩略图条目后，应完全关闭文件管理器，以便它能够正确扫描并注册该条目。您可以通过发出以下命令之一来执行此操作：
nautilus -q nemo -q caja -q - 接下来，删除失败缩略图的缓存，以强制文件管理器为以前的缩略图制作器无法生成缩略图的文件重新生成缩略图：
rm -r ~/.cache/thumbnails/fail - 或者，如果之前使用了未优化的缩略图条目或脚本，则可以删除所有缓存的缩略图：
rm -r ~/.cache/thumbnails/* - 最后，重新打开文件管理器。现在，mime-type 为该
MimeType键的文件应该有缩略图了。如果没有，则意味着出了问题，但不用担心，这就是以下部分的目的。
- 创建新的缩略图条目后，应完全关闭文件管理器，以便它能够正确扫描并注册该条目。您可以通过发出以下命令之一来执行此操作：
缩略图故障排除
找出缩略图出现问题的最佳方法之一是运行启用了调试消息的文件管理器：
- 首先，使用以下命令之一完全关闭文件管理器：
nautilus -q nemo -q caja -q - 清除所有缓存的缩略图：
rm -r ~/.cache/thumbnails/* - 从启用调试代码的终端启动文件管理器：
- 转到
~/.cache/thumbnails，现在它应该是空的。 - 在新选项卡中打开包含要缩略图的文件类型的文件夹。此时，可能会发生三件事：
- 在 中创建了一个
large或目录。这表示缩略图制作成功，并且已为您的文件生成缩略图。normal~/.cache/thumbnails - 未创建目录
~/.cache/thumbnails（即目录保持为空）。这意味着未执行密钥中的命令Exec，因此，没有缩略图已创建。请参阅下一节，了解造成这种情况的可能原因。 fail在 中创建了一个目录~/.cache/thumbnails。这意味着文件管理器确实尝试在Exec密钥中执行命令，但有些东西阻止了缩略图的创建，导致缩略图失败。终端的错误消息可能会提供出错原因的线索。您还可以在下一节中找到一些常见原因。
- 在 中创建了一个
- 退出调试模式：
- Nautilus & Nemo：关闭文件管理器并在终端中按Ctrl+ 。C
- Caja：关闭文件管理器，Enter在终端中按下，然后输入
quit并按下Enter。
笔记：
对于不提供该
--debug选项的旧版本 Nemo，请改用gdb：gdb nemo如果你在 MATE 会话中使用 Caja（例如在 Ubuntu MATE 上），则必须
gdb以 root 身份运行（请参阅这更多细节）：sudo gdb caja在这种情况下，您只能对主目录内的缩略图条目
/usr/share/thumbnailers和主目录外的缩略图脚本进行故障排除。或者，您可以使用蚀调试 Caja 和缩略图。
缩略图问题
本节讨论了可能导致没有缩略图或者缩略图失败。
大文件没有缩略图
Nautilus、Nemo 和 Caja 对可缩略图文件设置了大小限制。大小超过此限制的文件将只显示通用图标，无论是否存在适合该类型的有效缩略图程序。
要更改此大小限制：
- 打开文件管理器，转到优先→预览（Nemo、Caja）或搜索和预览（鹦鹉螺）标签。
- 选择文件大小仅适用于小于的文件。
没有远程文件的缩略图
当您通过网络浏览其他计算机上的文件时，Nautilus、Nemo 和 Caja 默认不会为它们创建缩略图。
要启用这些文件的缩略图预览：
- 打开文件管理器，转到优先→预览（Nemo、Caja）或搜索和预览（鹦鹉螺）标签。
- 放显示缩略图到全部文件（鹦鹉螺），是的（尼莫），或总是（卡哈）。
某些文件夹中的文件没有缩略图
尼莫可能会禁用某些文件夹中文件的缩略图：
- 打开一个文件夹，然后点击看法在菜单栏中。
- 如果显示缩略图未选中，则该文件夹中的文件缩略图将被禁用。
- 点击编辑在菜单栏中 →优先→预览标签。
- 如果从父级继承缩略图可见性被选中，那么该文件夹的子文件夹中的文件缩略图也可能会关闭。
要重新启用文件夹中文件的缩略图预览：
- 打开文件夹，然后单击看法在菜单栏中。
- 确保显示缩略图已检查。
某些文件类型没有缩略图
文件管理器可能会禁用某些 mime 类型的缩略图。要检查是否是这种情况，请分别针对 Nautilus、Nemo 和 Caja 发出以下命令之一：
gsettings get org.gnome.desktop.thumbnailers disable
gsettings get org.cinnamon.desktop.thumbnailers disable
gsettings get org.mate.thumbnailers disable
如果结果为[]或['']，则文件管理器不会禁用任何文件类型的缩略图。但是，如果括号中有 MIME 类型，例如['image/jp2']、['image/jp2', 'application/x-ms-dos-executable']等，则不会创建这些类型的文件的缩略图。
要为所有文件类型启用缩略图预览，请发出以下命令之一（分别针对 Nautilus、Nemo 和 Caja）：
gsettings set org.gnome.desktop.thumbnailers disable "[]"
gsettings set org.cinnamon.desktop.thumbnailers disable "[]"
gsettings set org.mate.thumbnailers disable "[]"
或者，您可以使用dconf 编辑器：
- 首先，安装
dconf-editor：sudo apt install dconf-editor - 打开dconf 编辑器，然后前往以下其中一个地方（分别针对 Nautilus、Nemo 和 Caja）：
- 组织→侏儒→桌面→缩略图制作者→禁用。
- 组织→肉桂→桌面→缩略图制作者→禁用。
- 组织→伴侣→桌面→缩略图制作者→禁用。
- 关使用默认值。
- 更改自定义值框或
[]为['']所有文件类型启用缩略图，或者有选择地从列表中删除某些 mime 类型以仅重新启用这些类型的预览。 - 点击申请在窗口的右下角。
所有文件均无缩略图
所有文件的缩略图预览可能被禁用。您需要检查两个地方：
文件管理器首选项：
- 打开文件管理器，转到优先→预览（Nemo、Caja）或搜索和预览（鹦鹉螺）标签。
- 如果显示缩略图被设定为不（尼莫）或绝不（Nautilus、Caja），文件管理器不会为任何文件创建或显示缩略图。
- 要重新启用预览，请设置显示缩略图到仅限本地文件（Nemo、Caja）或仅限此计算机上的文件（Nautilus）。或者，您可以将此功能设置为全部文件（鹦鹉螺），是的（尼莫），或总是（Caja）还可以预览远程文件。
桌面环境设置：
分别针对 Nautilus、Nemo 和 Caja 发出以下命令之一：
gsettings get org.gnome.desktop.thumbnailers disable-all gsettings get org.cinnamon.desktop.thumbnailers disable-all gsettings get org.mate.thumbnailers disable-all结果应该是
false，这是默认值，但如果是true，则所有缩略图都将被禁用，因此不会生成任何缩略图。要重新启用缩略图，请发出以下命令之一（分别针对 Nautilus、Nemo 和 Caja）：
gsettings set org.gnome.desktop.thumbnailers disable-all false gsettings set org.cinnamon.desktop.thumbnailers disable-all false gsettings set org.mate.thumbnailers disable-all false或者，您可以使用dconf 编辑器：
- 首先，安装
dconf-editor：sudo apt install dconf-editor - 打开dconf 编辑器，然后前往以下其中一个地方（分别针对 Nautilus、Nemo 和 Caja）：
- 组织→侏儒→桌面→缩略图制作者
- 组织→肉桂→桌面→缩略图制作者
- 组织→伴侣→桌面→缩略图制作者
- 关禁用所有外部缩略图。
- 点击重新加载在窗口的右上角。
- 首先，安装
由于缺少编解码器导致缩略图失败
缩略图程序缩略某些文件类型所需的编解码器可能不可用，因为它们未与程序捆绑在一起或由其依赖项之一提供。例如，totem-video-thumbnailer需要gstreamer1.0-libav缩略 MP4 和其他视频文件，但gstreamer1.0-libav只是一个建议包，因此没有安装totem-video-thumbnailer。
要查找丢失的编解码器，请尝试使用终端中的缩略图程序从要缩略图的文件类型创建 PNG 图像。终端中的错误消息可能会提供有关转换所需的编解码器库的线索。如果程序有选项verbose，您可能希望使用它来获取更多调试信息。例如：
totem-video-thumbnailer --size 256 --verbose in.webp out.png
另一种方法是尝试建议包并查看其中是否提供了所需的编解码器：
- 用于
apt-cache depends获取建议的软件包列表。例如：apt-cache depends totem | grep Suggest apt-cache depends ffmpegthumbnailer | grep Suggest - 用于
apt-cache show获取每个建议包的信息。例如：apt-cache show gstreamer1.0-libav apt-cache show gstreamer1.0-plugins-bad - 如果这些信息不能帮助您确定哪个包包含编解码器，您可能需要尝试逐个安装建议的包。
需要注意的是，官方存储库中也可能没有该编解码器，或者相关程序根本不支持您尝试缩略的文件类型。在这种情况下，建议访问该程序的官方网站以获取有关支持格式的更多信息，或者直接使用其他缩略图程序。
由于文件扩展名不正确导致缩略图失败
您尝试预览的文件的文件扩展名可能不正确，这会导致调用不适当的缩略图程序来缩略它们。例如，我曾经有一些扩展名为的文件.jpg，但它们实际上是 WebP 图像。文件管理器无论如何都会将它们视为 JPEG 图像并将它们传递给gdk-pixbuf-thumbnailer。由于该程序无法处理 WebP 图像，因此缩略图制作失败。
要解决此问题，您需要使用该file工具获取这些文件的真实类型并相应地重命名它们。例如，要检查image.png中的类型~/Pictures，请发出以下命令：
file ~/Pictures/image.png
如果该文件确实是 PNG 图像，则输出将类似于以下内容：
/home/calico/Pictures/image.png: PNG image data, 1024 x 640, 8-bit/color RGB, non-interlaced
当file扫描文件内容以确定其类型时，即使您尝试为文件指定不同的扩展名，结果也是一样的：
/home/calico/Pictures/image.png.gif: PNG image data, 1024 x 640, 8-bit/color RGB, non-interlaced
有趣的是，如果在更改扩展名之前和之后检查文件的 mime 类型xdg-mime，会有两个不同的结果：
$ xdg-mime query filetype ~/Pictures/image.png
image/png
$ mv ~/Pictures/image.png ~/Pictures/image.png.gif
$ xdg-mime query filetype ~/Pictures/image.png.gif
image/gif
由于无法识别图像文件格式，导致缩略图失败
正如在缩略图和缩略图条目部分，Nemo 和 Caja（以及 Nautilus 的旧版本）为每个输出缩略图提供了一个随机.XXXXXX后缀，而不是图像扩展名。如果缩略图程序默认不以 PNG 格式（或 支持的格式gdk-pixbuf-thumbnailer）写入文件，它将无法为这些文件管理器创建缩略图。
幸运的是，专门设计为缩略图制作器的程序（例如ffmpegthumbnailer和totem-video-thumbnailer）通常默认会创建 PNG 缩略图。对于不默认此设置的其他程序，必须明确指定输出文件的格式，以确保生成有效的缩略图。
如果程序有一个方便的选项来指定格式，那就最好了。例如，converthaspng:和ffmpeghas -f apng：
Exec=/usr/bin/convert %i png:%o
Exec=/usr/bin/ffmpeg -i %i -f apng %o
对于没有此选项的程序，通用解决方案是首先为输出文件提供后缀.png，然后将其重命名为文件管理器提供的原始文件名。这可以在 shell 脚本中完成。例如：
#!/bin/bash
infile="$1"
outfile="$2"
/usr/bin/opj_decompress -i "$infile" -o "$outfile".png
mv "$outfile".png "$outfile"
尽管输出图像文件可以是任何支持的格式gdk-pixbuf-thumbnailer（JPEG、PNG、BMP、GIF、TGA 等），但建议使用 PNG 格式创建缩略图安全原因。
由于缩略图程序沙盒化，缩略图显示失败
最新版本鹦鹉螺 沙盒缩略图并且只允许缩略图制作过程访问某些目录。如果缩略图制作程序需要文件或位于沙盒之外的目录中，缩略图制作将失败。
要获取沙箱上挂载的目录列表，请执行以下操作：
- 使用以下方法完全关闭 Nautilus：
nautilus -q - 清除所有缓存的缩略图：
rm -r ~/.cache/thumbnails/* - 从终端启动 Nautilus 并启用调试代码：
G_MESSAGES_DEBUG=all NAUTILUS_DEBUG=Window nautilus - 转到包含可缩略图文件（图像、视频等）的文件夹。
- 在终端中找到类似这样的消息：
About to launch script: bwrap --ro-bind /usr /usr --ro-bind /etc/ld.so.cache /etc/ld.so.cache --symlink /usr//bin /bin --symlink /usr//lib64 /lib64 --symlink /usr//lib /lib --symlink /usr//sbin /sbin --ro-bind-try /var/cache/fontconfig /var/cache/fontconfig --ro-bind-try /etc/alternatives /etc/alternatives --proc /proc --dev /dev --chdir / --setenv GIO_USE_VFS local --unshare-all --die-with-parent --setenv G_MESSAGES_DEBUG all --bind /tmp/gnome-desktop-thumbnailer-90H120 /tmp --ro-bind /home/calico/Pictures/image.webp /tmp/image.webp --seccomp 36 /usr/bin/gdk-pixbuf-thumbnailer -s 256 file:///tmp/image.webp /tmp/gnome-desktop-thumbnailer.png - 注意
--bind、--ro-bind、--ro-bind-try和--symlink选项。每个选项后面的参数是挂载在沙箱上的文件或目录。
要避免使用 Nautilus 时缩略图失败：
- 如果您使用缩略图脚本，请确保将它们放在沙箱上安装的目录中（例如
/usr/local/bin）。 - 如果缩略图程序确实需要沙箱外目录中的文件，则可以使用以下脚本这个经过尼古拉斯·伯纳茨可用于将这些目录添加到沙盒中。但是，这样做可能会破坏沙盒缩略图的目的，因此最好使用另一个在沙盒方面没有问题的缩略图程序。
要了解有关沙盒程序（bubblewrap）及其选项的更多详细信息，请运行以下命令：
man bwrap