QuickLook Video：三步装好，Finder 里 MKV、WebM 视频也有缩略图和预览了
【免费下载链接】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
下载一批 MKV 文件后在 Finder 图标视图里翻找，看到的却是一排没有画面、没有时长的通用图标。QuickLook Video 就是补这个缺口的：它给 macOS 的大多数视频和音频格式加上缩略图、Quick Look 预览和"显示简介"里的元数据，不用装第三方播放器逐个点开确认。
QuickLook Video 具体做了 4 件事
- Finder 缩略图：MKV、WebM、AVI、MOV、FLV、MXF 等文件在图标视图里直接显示真实画面帧，文件名下方还带播放时长。
- Quick Look 预览：选中视频按空格键，直接在预览窗里播放，带进度条、音量和"用其他 App 打开"按钮。
- "显示简介"元数据：信息面板能读出编码格式等参数，不再只有大小和日期。
- Spotlight 搜索：自带 Spotlight 扩展，这些文件类型可以正常被系统检索并读取元数据。
三步装好 QuickLook Video：编译、开扩展、验证
前置要求：装有 Xcode（macOS 12 SDK 或更新）和 Homebrew 的 Mac。
第 1 步，克隆仓库并编译。项目内置 FFmpeg、dav1d（AV1 解码）和 zimg，需要先把子模块拉下来：
git clone https://gitcode.com/gh_mirrors/ql/QuickLookVideo cd QuickLookVideo git submodule update --init --recursiveFFmpeg 及其依赖还需要 meson、ninja、pkg-config 和 nasm：
brew install meson ninja pkg-config nasm然后执行 Release 编译：
xcodebuild -project QLVideo.xcodeproj -configuration Release第 2 步，开启扩展。安装后打开"系统设置"，在扩展开关里确认三项：QLVideo media formats、QLVideo video codecs 和 Spotlight 都是打开状态。
第 3 步，验证。回到装有 MKV 或 WebM 文件的文件夹，缩略图和时长应该已经生成；按空格键确认能预览播放即可。
视频预览最常用的 3 个场景
- 整理下载目录：像上面截图里的剧集那样，一批 MKV 落盘后不用逐个点开，图标视图里就能看到每集画面和 40 分钟左右的时长，哪集缺了、哪集是重复的，扫一眼就知道。
- 先看再开：拿不准要不要看的文件，空格键预览几秒再决定。不想看就再按空格关掉，不用等 VLC 加载。
- 核对技术规格：按 Option + I 打开"显示简介"，直接看编码、分辨率这类参数，核对转码素材是否达标。
缩略图不显示时，先查这 2 个地方
- 扩展开关没打开：系统设置里确认"QLVideo media formats"和"QLVideo video codecs"两项是开启状态；刚装完不生效时，重启一次 Mac 最省事。
- 看解码日志：各扩展都会把输出写到系统日志。用 Console 应用过滤
subsystem:uk.org.marginal.qlvideo，或在终端跑sudo log stream --predicate 's=uk.org.marginal.qlvideo'，就能看到解码过程中发生了什么。
它适合谁
如果你经常接触 MKV、WebM 这类系统原生不认的视频格式——不管是整理家庭影音库、收集素材，还是做字幕和转录工作——把 Finder、Quick Look 和 Spotlight 补全到能直接用，值得装一个。
【免费下载链接】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），仅供参考
