Mac 视频预览不认 MKV 和 AVI？一个开源扩展让 Finder 缩略图与 QuickLook 播放全格式通吃

Mac 视频预览不认 MKV 和 AVI一个开源扩展让 Finder 缩略图与 QuickLook 播放全格式通吃【免费下载链接】QuickLookVideoFinder Thumbnails, Quick Look previews, Get Info metadata and previews for most types of audio and video files.项目地址: https://gitcode.com/gh_mirrors/ql/QuickLookVideoMac 原生预览只认 MPEG 家族的媒体文件MKV、AVI 这类常见格式放进文件夹往往只剩空白图标。QLVideo 是一个开源系统扩展用三个后台组件让 Finder 缩略图、空格预览和 Spotlight 搜索覆盖绝大多数音视频格式适合用 Mac 下载、整理视频的普通用户。这套工具的价值不在于多一个播放器而在于把能力直接塞进系统原本的入口你不用学新软件、不用改操作习惯装好后一切都在熟悉的地方发生。下面从最直观的变化讲起。先认清一个现实原生能力只覆盖了很小一块macOS 自带的 QuickLook、Spotlight 和 AVFoundation 对媒体的理解主要停留在 MPEG 容器内的 MPEG 编码。换言之系统内置的预览能力只服务一小撮正规军格式从网络下载、从设备导出的绝大多数文件都不在名单里。老 Mac 用户或许记得 Perian——一个为 QuickTime 时代补全解码能力的著名插件。QLVideo 扮演的角色与之类似只不过它服务的是今天基于 AVFoundation 的新生态并且以开源方式持续迭代。安装之后三个场景的变化最直观 与其听功能清单不如直接看装完会在哪里感受到区别。场景一打开文件夹缩略图和时长一起出现没装之前装满 MKV 的文件夹就是一排白纸图标只能靠文件名猜内容。装上 QLVideo 后Finder 会为每个视频生成真实画面缩略图并在缩略图下方标出时长。文件一多扫一眼就知道是什么的效率差距立刻显现。场景二按下空格直接进入可播放的预览选中视频按空格弹出的 QuickLook 窗口不只是定格一帧画面而是带完整播放控制的预览播放/暂停、前后跳 15 秒、拖动进度条、调节音量右上角还提供按钮可一键交给外部播放器如 VLC接管。想快速判断画质、核对某段内容都不必再启动完整的播放软件。场景三右键显示简介元数据不再一片空白音频文件在 Get Info 窗口里能看到比特率、采样率等参数视频文件也能拿到更完整的属性描述。批量整理文件时这些信息比逐个打开确认省事得多。支持范围横跨容器格式与编码格式的清单QLVideo 的覆盖范围可以从两个维度理解这也解释了它凭什么通吃容器/文件格式Matroska.mkv、.mka、WebM.webm、Windows Media.wma、.wmv、Ogg Video.ogm、.ogv、AVI.avi、QuickTime.mov、Flash Video.flv、.f4v、Real Media.ra、.rm、.rv、SMPTE.gxf、.mxf视频编码VP6/VP8/VP9、AV1、HEVC/H.265、VVC/H.266、Dolby Vision、Theora、Sorenson、Cinepak、DivX、Intel Indeo、HAP、DXV、AIC 等音频编码Vorbis、Windows Media Audio、WavPak、ATRAC 等无论是老片源的 DivX还是新趋势下的 AV1、HEVC这份名单基本覆盖了日常会碰到的绝大多数情况。动手安装四步走半小时内搞定第一步确认环境需要macOS 12 或更高版本装有 Xcode含命令行工具并建议配好 Homebrew 包管理器。第二步拉取源码安装构建依赖打开终端克隆项目仓库git clone https://gitcode.com/gh_mirrors/ql/QuickLookVideo cd QuickLookVideo然后用 Homebrew 一次性装齐构建所需工具brew install meson ninja pkg-config nasm第三步编译三个核心组件项目在scripts/目录下提供了现成脚本按顺序执行即可./scripts/builddav1d ./scripts/buildffmpeg ./scripts/buildzimg第四步Xcode 打包安装并验证用 Xcode 打开QLVideo.xcodeproj选择 Build 构建运行。装好后重启 Finder按住 Option 键点击 Finder 图标 → 重新开启再打开存有视频的文件夹缩略图与空格预览应当已经生效。三个开关掌控扩展的取舍 ⚙️设置面板位于app/目录对应的应用程序中界面简洁到只有三个开关QLVideo media formats是否启用对非原生媒体格式的支持QLVideo video codecs是否启用扩展的视频解码能力Spotlight是否让 Spotlight 搜索也识别这些格式按需切换即可。比如你只想补视频能力、不想让音频参与搜索关掉对应开关就行。预览出问题时用日志自己排查 如果某个文件仍然无法预览可以从系统日志里找原因sudo log stream --style compact --debug --predicate suk.org.marginal.qlvideo日志会记录扩展的运行状态结合报错信息基本能定位是格式不支持还是文件本身损坏。多数情况下默认设置已能满足绝大多数需求遇到个别专业格式优先检查设置面板里的两个编解码器开关。关于它最常见的三个疑问装了这个会不会拖慢系统扩展只在生成缩略图或触发预览时工作日常几乎零占用。遇到不兼容的文件会安全跳过不影响系统其它功能。是不是每个用户都要装一次是的。macOS 的安全机制要求扩展按用户安装同一台机器的多个账户需要分别安装。新格式支持跟得上吗QLVideo 基于 FFmpeg 构建而 FFmpeg 是业界格式支持最全面的引擎之一AV1、HEVC 等较新编码都已包含。结语如果你的视频管理流程里长期存在看不见、打不开、搜不到的困扰QLVideo 提供了成本最低的解法无需转码、无需换播放器、无需改变操作习惯装好即融入系统原生路径。项目以 GPL v2 或更高版本开源想深入了解实现的话也可以直接翻看源码——视频解码扩展位于videodecoder/媒体扩展与设置界面位于app/构建脚本集中在scripts/。现在就去装上它让文件夹里的每一段视频都变得一目了然。【免费下载链接】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），仅供参考