Mac 预览不了 MKVQuickLookVideo 把 Finder 变成全能视频预览工具【免费下载链接】QuickLookVideoFinder Thumbnails, Quick Look previews, Get Info metadata and previews for most types of audio and video files.项目地址: https://gitcode.com/gh_mirrors/ql/QuickLookVideo在 Mac 上双击一个 .mkv 文件看到的是白纸图标按下空格键屏幕纹丝不动。这不是你操作错了而是 macOS 原生就不认识这类文件。QuickLookVideo 是一款开源的免费视频预览工具它的目标很朴素让 Finder 缩略图、空格键快速预览、文件信息和 Spotlight 搜索都能识别大多数音频视频格式装完即用不改变任何操作习惯。一个星期天晚上的翻车现场你从网上下了一部 MKV 格式的美剧双击没反应右键快速查看也是黑屏只能拖进第三方播放器进度条、截图、元数据全靠手动折腾。更糟的是文件夹里几十个视频全是白纸图标想靠缩略图找到想看的那一集根本不可能——这大概就是Mac 视频缩略图不显示最常见的来源。Mac 用户常把这个问题归结为格式兼容但准确地说这是系统权限问题。问题不在你的电脑在系统那份白名单macOS 自带的 QuickLook、AVFoundation 和 Spotlight认识的文件其实很少基本上只有 MP4、MOV 这类 MPEG 容器里的常见编码。MKV、WebM、AVI、FLV、WMV以及 VP9、AV1、HEVC 这些编码都在系统的白名单之外于是系统干脆把它们当成不可识别文件处理。有意思的是开源界的 FFmpeg 几乎认识所有格式只是 macOS 不会主动调用它。QuickLookVideo 做的事就是把 FFmpeg 读格式、解编码的能力翻译成 macOS 自己那套预览管道能听懂的语言——它不造一个新播放器而是让系统自己学会。装上之后Finder 像换了台新电脑装好 QuickLookVideo重启 Finder再打开那个装满 MKV 的文件夹白纸图标变成了清晰的视频画面缩略图缩略图下方还多了一行时长信息。几十个文件一眼扫过去哪一集是哪一集清清楚楚。空格键从白屏变成播放器选中文件按空格QuickLook 窗口直接开始播放。进度条、播放暂停、音量、前后跳 15 秒一个不少右上角还有个按钮可以一键切换到 VLC 等外部播放器。不用打开任何软件就能确认画质、字幕和内容检查素材的效率完全不是一个量级。顺便一提选中文件按 CommandI 打开显示简介原本空白的媒体信息也有了内容Spotlight 里直接搜文件名也能搜到这些视频了——Spotlight 搜不到视频文件的苦恼一并解决。它是怎么教会系统的不用读代码也能懂项目里其实有三个小部件各管一摊formatreader 模块负责把 MKV、AVI、FLV 这些容器拆开也负责 Vorbis、WMA 等音频编码videodecoder 模块负责把 VP9、AV1、HEVC 这些视频编码解出来mdimporter 模块专门给 Spotlight 提供元数据让搜索能命中这些文件它们都挂在 macOS 的扩展机制上系统在需要缩略图、预览或索引时会自动去调用。老 Mac 用户可能记得 QuickTime 时代的 Perian 插件QuickLookVideo 可以看作它在 AVFoundation 时代的继任者。想深入了解实现可以看 BUILDING.md 和源码里的 formatreader/、videodecoder/、mdimporter/ 目录。从零装好四步够用如果不想折腾直接从 Mac App Store 装好即可。想自己编译也简单先准备编译工具brew install meson ninja pkg-config nasm克隆源码git clone https://gitcode.com/gh_mirrors/ql/QuickLookVideo依次执行 scripts 目录下的builddav1d、buildffmpeg、buildzimg分别编译 AV1 解码器、FFmpeg 库和格式转换库用 Xcode 打开QLVideo.xcodeprojBuild 一次唯一要注意的硬件门槛3.x 版本需要 macOS 12 以上且 CPU 支持 AVX22013 年底之后的 Mac 基本都没问题。装完顺手做的三件小事打开应用的偏好设置有三个开关QLVideo 媒体格式、QLVideo 视频编解码器以及 Spotlight 搜索增强。默认全开一般不用动但如果某个格式偶尔出问题可以先关掉对应开关排查。另外两件小事重启一次 Finder 让缓存重建第一次打开装满视频的大文件夹时缩略图生成会慢一些属于正常现象生成完一轮后就快了。一个藏在源码里的体贴细节视频文件经常是残缺的——下载了一半、拷贝损坏都很常见。这类文件会让 FFmpeg 直接崩溃而 QuickLookVideo 在正式版里装了异常处理器worker 进程崩掉就悄悄重启不会把崩溃弹窗甩到你脸上。你顶多看到某张图没生成而不会被打断工作。设置里甚至能选缩略图取哪一帧默认是视频 25% 处这种务实的设计往往比花哨功能更贴心。现在就可以动手装好、重启 Finder、按下空格键 。如果哪个格式还是不行用sudo log stream --style compact --debug --predicate suk.org.marginal.qlvideo看一眼日志多半能找到原因。【免费下载链接】QuickLookVideoFinder Thumbnails, Quick Look previews, Get Info metadata and previews for most types of audio and video files.项目地址: https://gitcode.com/gh_mirrors/ql/QuickLookVideo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Mac 预览不了 MKV？QuickLookVideo 把 Finder 变成全能视频预览工具
Mac 预览不了 MKVQuickLookVideo 把 Finder 变成全能视频预览工具【免费下载链接】QuickLookVideoFinder Thumbnails, Quick Look previews, Get Info metadata and previews for most types of audio and video files.项目地址: https://gitcode.com/gh_mirrors/ql/QuickLookVideo在 Mac 上双击一个 .mkv 文件看到的是白纸图标按下空格键屏幕纹丝不动。这不是你操作错了而是 macOS 原生就不认识这类文件。QuickLookVideo 是一款开源的免费视频预览工具它的目标很朴素让 Finder 缩略图、空格键快速预览、文件信息和 Spotlight 搜索都能识别大多数音频视频格式装完即用不改变任何操作习惯。一个星期天晚上的翻车现场你从网上下了一部 MKV 格式的美剧双击没反应右键快速查看也是黑屏只能拖进第三方播放器进度条、截图、元数据全靠手动折腾。更糟的是文件夹里几十个视频全是白纸图标想靠缩略图找到想看的那一集根本不可能——这大概就是Mac 视频缩略图不显示最常见的来源。Mac 用户常把这个问题归结为格式兼容但准确地说这是系统权限问题。问题不在你的电脑在系统那份白名单macOS 自带的 QuickLook、AVFoundation 和 Spotlight认识的文件其实很少基本上只有 MP4、MOV 这类 MPEG 容器里的常见编码。MKV、WebM、AVI、FLV、WMV以及 VP9、AV1、HEVC 这些编码都在系统的白名单之外于是系统干脆把它们当成不可识别文件处理。有意思的是开源界的 FFmpeg 几乎认识所有格式只是 macOS 不会主动调用它。QuickLookVideo 做的事就是把 FFmpeg 读格式、解编码的能力翻译成 macOS 自己那套预览管道能听懂的语言——它不造一个新播放器而是让系统自己学会。装上之后Finder 像换了台新电脑装好 QuickLookVideo重启 Finder再打开那个装满 MKV 的文件夹白纸图标变成了清晰的视频画面缩略图缩略图下方还多了一行时长信息。几十个文件一眼扫过去哪一集是哪一集清清楚楚。空格键从白屏变成播放器选中文件按空格QuickLook 窗口直接开始播放。进度条、播放暂停、音量、前后跳 15 秒一个不少右上角还有个按钮可以一键切换到 VLC 等外部播放器。不用打开任何软件就能确认画质、字幕和内容检查素材的效率完全不是一个量级。顺便一提选中文件按 CommandI 打开显示简介原本空白的媒体信息也有了内容Spotlight 里直接搜文件名也能搜到这些视频了——Spotlight 搜不到视频文件的苦恼一并解决。它是怎么教会系统的不用读代码也能懂项目里其实有三个小部件各管一摊formatreader 模块负责把 MKV、AVI、FLV 这些容器拆开也负责 Vorbis、WMA 等音频编码videodecoder 模块负责把 VP9、AV1、HEVC 这些视频编码解出来mdimporter 模块专门给 Spotlight 提供元数据让搜索能命中这些文件它们都挂在 macOS 的扩展机制上系统在需要缩略图、预览或索引时会自动去调用。老 Mac 用户可能记得 QuickTime 时代的 Perian 插件QuickLookVideo 可以看作它在 AVFoundation 时代的继任者。想深入了解实现可以看 BUILDING.md 和源码里的 formatreader/、videodecoder/、mdimporter/ 目录。从零装好四步够用如果不想折腾直接从 Mac App Store 装好即可。想自己编译也简单先准备编译工具brew install meson ninja pkg-config nasm克隆源码git clone https://gitcode.com/gh_mirrors/ql/QuickLookVideo依次执行 scripts 目录下的builddav1d、buildffmpeg、buildzimg分别编译 AV1 解码器、FFmpeg 库和格式转换库用 Xcode 打开QLVideo.xcodeprojBuild 一次唯一要注意的硬件门槛3.x 版本需要 macOS 12 以上且 CPU 支持 AVX22013 年底之后的 Mac 基本都没问题。装完顺手做的三件小事打开应用的偏好设置有三个开关QLVideo 媒体格式、QLVideo 视频编解码器以及 Spotlight 搜索增强。默认全开一般不用动但如果某个格式偶尔出问题可以先关掉对应开关排查。另外两件小事重启一次 Finder 让缓存重建第一次打开装满视频的大文件夹时缩略图生成会慢一些属于正常现象生成完一轮后就快了。一个藏在源码里的体贴细节视频文件经常是残缺的——下载了一半、拷贝损坏都很常见。这类文件会让 FFmpeg 直接崩溃而 QuickLookVideo 在正式版里装了异常处理器worker 进程崩掉就悄悄重启不会把崩溃弹窗甩到你脸上。你顶多看到某张图没生成而不会被打断工作。设置里甚至能选缩略图取哪一帧默认是视频 25% 处这种务实的设计往往比花哨功能更贴心。现在就可以动手装好、重启 Finder、按下空格键 。如果哪个格式还是不行用sudo log stream --style compact --debug --predicate suk.org.marginal.qlvideo看一眼日志多半能找到原因。【免费下载链接】QuickLookVideoFinder Thumbnails, Quick Look previews, Get Info metadata and previews for most types of audio and video files.项目地址: https://gitcode.com/gh_mirrors/ql/QuickLookVideo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考