Yazi文件管理器：如何禁用MP4视频预览功能

Yazi是一款现代化的终端文件管理器，它提供了强大的文件预览功能。其中对于视频文件（如MP4格式）的预览支持可能会在某些情况下带来性能问题或资源占用过高的情况。本文将详细介绍如何在Yazi中禁用MP4视频的预览功能。

问题背景

Yazi默认会使用ffmpeg工具来生成视频文件的预览缩略图。当用户浏览包含大量MP4文件的目录时，Yazi会同时启动多个ffmpeg进程来生成这些预览图。虽然系统默认限制最多同时运行10个ffmpeg进程（通过max_preview_processes参数控制），但在某些低配置设备上，这仍可能导致系统资源紧张。

解决方案

Yazi提供了灵活的配置选项，允许用户完全禁用特定类型文件的预览功能。对于MP4视频文件，可以通过修改配置文件来实现这一目的。

方法一：禁用MP4文件预览

在Yazi的配置文件yazi.toml中添加以下内容：

prepend_preloaders = [
    { mime = "video/mp4", run = "noop" },
]
prepend_previewers = [
    { mime = "video/mp4", run = "noop" },
]

这段配置的作用是：

1. prepend_preloaders：在预加载阶段对MP4文件不做任何处理
2. prepend_previewers：在预览阶段对MP4文件不做任何处理
3. noop表示"no operation"，即不执行任何操作

方法二：禁用所有视频文件预览

如果需要禁用所有视频格式的预览（包括MP4、AVI、MOV等），可以使用通配符配置：

prepend_preloaders = [
    { mime = "video/*", run = "noop" },
]
prepend_previewers = [
    { mime = "video/*", run = "noop" },
]

技术原理

Yazi的文件预览系统分为两个阶段：

1. 预加载阶段：快速获取文件的基本信息
2. 预览阶段：生成详细的预览内容

通过将特定MIME类型的处理规则设置为noop，可以跳过这两个阶段的处理流程，从而避免启动ffmpeg等外部工具。

注意事项

1. 修改配置后需要重启Yazi才能使更改生效
2. 禁用预览功能后，视频文件将只显示文件名和基本信息
3. 此配置不会影响其他类型文件（如图片、文本等）的预览功能
4. 如果需要重新启用预览功能，只需删除或注释掉相关配置即可

总结

Yazi提供了高度可定制的预览系统，用户可以根据自己的需求灵活配置不同文件类型的预览行为。通过禁用MP4或其他视频文件的预览功能，可以有效降低系统资源消耗，特别是在处理大量视频文件时。这种配置方式既简单又不会影响Yazi的其他功能，是解决视频预览资源占用问题的理想方案。