Owl：为文件夹视频而生的 macOS 原生播放器 #
Owl 是什么？ #
Owl 是一款面向 macOS 的原生视频播放器，基于 SwiftUI 与 libmpv 构建，专门为“以文件夹整理视频”的使用习惯而设计。
与需要逐个拖入文件的传统播放器不同，Owl 允许你直接把整个文件夹变成媒体库：它会把这些文件夹以缩略图网格的形式展示出来，并持续监听文件夹内的变化，新加入的视频会自动出现。播放能力上，Owl 几乎兼容所有常见封装格式——MKV、MP4、MOV、AVI、WebM，乃至 4K HDR 内容，并借助硬件加速保证流畅度，同时无需安装 Homebrew 或额外依赖即可运行。
它解决的核心痛点是：本地影音收藏越攒越多、番剧与课程分门别类存放，却缺少一个既能管理文件夹、又能高质量播放、还能记住观看进度的工具。Owl 把“库管理”和“专业播放”合二为一，适合影迷、追剧用户、影视素材整理者，以及希望在 macOS 上获得接近 PotPlayer／IINA 体验的普通用户。
Owl 有哪些亮点特色？ #
- 文件夹即媒体库：把任意文件夹添加进 Owl，即可以缩略图网格浏览全部视频，文件夹内容变动会被自动监听刷新，无需手动重新扫描。支持按文件名或匹配到的片名搜索（⌘F），并按名称、添加日期或最近观看排序。
- TMDB 元数据同步：视频会自动与 The Movie Database 匹配，补全片名、简介与封面海报，让一堆只有文件名的视频瞬间变成规整的媒体库。该功能默认开启，可在 Options 菜单中一键关闭。
- 随时随地续播：每个文件都会独立记录播放位置与“已观看”状态，卡片上直接显示进度条，一眼就能看出哪些看了一半、哪些已经看完。
- 原生多窗口播放体验：每个视频都在独立窗口中播放，窗口按视频尺寸自适应；采用 Liquid Glass 风格的控件，在鼠标停止移动后自动隐藏，保持画面整洁。还可将窗口固定在最前，方便边看边做其他工作。
- Finder 快速预览扩展：内置 Quick Look 扩展，为已注册的视频格式（包括 MKV 与 WebM）提供缩略图与 QuickTime 风格的空格键预览：预览会按视频尺寸打开并直接播放，带玻璃质感的播放／暂停、进度与音量条，点击画面即可播放或暂停。
- 悬停时间线预览：鼠标悬停在进度条上即可看到对应画面帧，任何支持的格式都可使用，快速定位想看的片段。
- 稳定的字幕体验：支持内嵌字幕与外挂字幕轨道，可开启双语字幕同时显示；每个文件会记住所选的字幕轨道与延迟。即使外挂字幕的文件名与视频版本命名不一致，Owl 也能找到并加载。
- 实况文本与全尺寸截图：暂停画面后可直接选取、复制并翻译画面中的文字（包括字幕内容）；一键截图可按视频原始分辨率保存到系统截图文件夹，并可选择是否把字幕一起截入画面。
免费下载 Owl #
以下为 Owl 官方提供的安装包，点击链接即可下载。官方同时建议从 GitHub Releases 获取已签名并公证的 DMG 版本。
| 文件名 | 描述 | 大小 | 下载 |
|---|---|---|---|
| Owl.dmg | macOS 安装镜像（官网未在下载页标注具体版本号） | 30.2 MB | 夸克网盘 |
Owl 如何使用？ #
- 首次启动与添加文件夹：将 Owl 安装到“应用程序”并启动一次，随后把存放视频的文件夹添加到 Owl 中。添加完成后，该文件夹会以缩略图网格呈现，之后往里新增或删除视频，界面会自动同步。
- 搜索与排序：在文件夹内按
⌘F搜索，可按文件名或已匹配的片名查找；也可在名称、添加日期、最近观看三种方式之间切换排序，快速定位目标影片。 - 开始播放：点击任意卡片即可在独立窗口中播放，窗口大小与视频尺寸一致。移动鼠标会唤出控制条，停止移动后自动隐藏；点击画面可播放／暂停，需要边看边做别的事时可把窗口固定在最前。
- 调字幕与音频：播放时可切换内嵌或外挂字幕轨道、开启双语字幕、微调字幕延迟，也可选择音轨、调整 0.5×–2× 播放速度与章节跳转。这些选择会按文件记住，下次继续看时无需重设。
- 常用快捷键：
空格播放／暂停，←／→后退／前进 10 秒，↑／↓音量增减 5%，Page Up／Page Down上一／下一章节，Z／⇧Z字幕提前／延后 0.25 秒，J切换下一条字幕轨道（之后关闭字幕），O显示当前播放位置，S截图，⌃⌘F切换全屏。
小提示：在扩展使用方面，安装到“应用程序”并成功启动一次后，macOS 才会注册 Owl 的 Quick Look 扩展；若 Finder 中没有出现预览或缩略图，请前往“系统设置 → 通用 → 登录项与扩展 → 快速预览”，启用 Owl Preview 与 Owl Thumbnail，并确保 Finder 的“显示”菜单中已勾选“显示图标预览”。
Owl 的常见问题？ #
Q1：Owl 支持哪些系统和芯片？ 官方说明 Owl 是一款面向 macOS 26+ 与 Apple silicon（M 系列芯片） 的原生 SwiftUI 播放器，安装包为 arm64 架构。较旧的 macOS 版本或 Intel 机型官网未提供支持说明。
Q2：需要安装 Homebrew、mpv 或 ffmpeg 才能播放吗？ 不需要。正式发布的 DMG 已把 libmpv 与 ffmpeg 运行时打包在应用内，普通用户下载安装即可播放，无需任何命令行依赖。只有在自行编译开发版本时，才需要在构建机（而非最终用户机器）上安装 Homebrew 版 mpv 与 ffmpeg。
Q3：装了 Owl，Finder 里的视频为什么还是没有缩略图和空格预览？
请先确认 Owl 存放在 /Applications 目录并至少启动过一次——Quick Look 扩展会从应用包内加载运行时，其沙盒只允许读取该位置的资源。若仍不生效，请在“系统设置 → 通用 → 登录项与扩展 → 快速预览”中启用 Owl Preview 与 Owl Thumbnail，并在 Finder 的显示选项里开启“显示图标预览”。此外，没有可解码视频流的文件本身就无法生成视频缩略图。
Q4：Finder 预览里为什么没有加载外挂字幕？ 这是扩展沙盒的限制：扩展只被授权访问你所选中的那个文件，因此相邻的外挂字幕文件不会被读取。需要完整字幕、全分辨率与 HDR 播放时，请用 Owl 本体打开视频。
Q5：播放列表里出现英文简介和海报，可以关掉吗？ 可以。这是与 The Movie Database（TMDB）匹配的元数据同步功能，默认开启，在 Options 菜单 中即可关闭，关闭后界面只显示本地文件信息。
Q6：Owl 是免费的吗？如何更新？ Owl 以 GPLv3 许可开源发布（因为打包了 GPL 授权的 libmpv 与 ffmpeg 构建），可免费使用与查看源码。正式版通过 Sparkle 自动更新，也可随时到 GitHub Releases 下载最新版 DMG 覆盖安装。
Owl 如何安装？ #
macOS（Apple silicon，macOS 26 及以上）
- 下载上表中的
Owl.dmg安装镜像，或前往 GitHub Releases 获取官方签名并公证的最新版本。 - 双击打开 DMG，将 Owl 拖入“应用程序”（Applications）文件夹。
- 首次打开时若系统提示安全确认，请在“系统设置 → 隐私与安全性”中允许来自该开发者的应用运行（官方发布包已签名与公证，正常情况可直接打开）。
- 启动 Owl 一次，让 macOS 注册其 Quick Look 扩展。
- 如需 Finder 缩略图与空格预览，进入“系统设置 → 通用 → 登录项与扩展 → 快速预览”，启用 Owl Preview 与 Owl Thumbnail。
- 添加你的视频文件夹，开始使用。
从源码构建（仅面向开发者）
- 准备 Xcode 26、XcodeGen，以及构建机上的 Homebrew 版 mpv 与 ffmpeg：
brew install mpv ffmpeg。 - 生成工程：
xcodegen generate。 - 可选：
./scripts/bundle-mpv-deps.sh把 libmpv/ffmpeg 依赖打包进deps/（调试构建可省略）。 - 编译：
xcodebuild -project Owl.xcodeproj -scheme Owl -configuration Release -destination 'platform=macOS,arch=arm64' -derivedDataPath build build，产物位于build/Build/Products/Release/Owl.app。 - 如需启用元数据同步，把 TMDB API Key 写入
.env（echo 'TMDB_API_KEY=<your key>' >> .env）后执行scripts/write-local-config.sh重新生成本地配置。
注意：若构建时未打包
deps/，应用会在运行时从 Homebrew 路径加载 libmpv 与 ffmpeg，可通过环境变量OWL_LIBMPV_PATH、OWL_FFMPEG_PATH、OWL_MPV_PATH覆盖路径。
Owl 如何卸载？ #
Owl 官网未提供专门的卸载说明，按 macOS 应用的标准做法操作即可：
- 退出应用：先完全退出 Owl（菜单栏选择“退出 Owl”，或在 Dock 图标上右键退出），避免文件占用。
- 关闭快速预览扩展：打开“系统设置 → 通用 → 登录项与扩展 → 快速预览”，取消勾选 Owl Preview 与 Owl Thumbnail，防止系统继续引用已删除的组件。
- 删除应用：打开“访达 → 应用程序”，将 Owl.app 拖入废纸篓（或右键“移到废纸篓”），随后清空废纸篓。
- 清理残留（可选）：若希望彻底移除个人设置与缓存，可在访达中通过“前往 → 前往文件夹”检查
~/Library/Preferences、~/Library/Caches、~/Library/Containers、~/Library/Saved Application State等目录下与 Owl 相关的条目并手动删除。注意：删除偏好设置会同时清空已添加的文件夹列表、播放进度与字幕轨道记忆，请在操作前确认。
卸载不会影响你硬盘中的原始视频文件；Owl 只是索引文件夹，不会移动或改写你的视频与字幕。