IINA：macOS 现代视频播放器

项目简介

IINA 是一款面向 macOS 的现代视频播放器，底层基于 mpv，因此具备 macOS 上出色的解码能力。它针对 macOS 11.0+ 设计，界面风格贴合现代系统，并持续处于活跃开发中。

项目主页：iina.io，你也可以在 GitHub Releases 或官网获取最新稳定版与测试版；想提前体验新特性，可从 Nightly 下载页获取每日构建版本。

主要功能

• 基于 mpv，提供 macOS 上优秀的解码性能
• 视频与音乐播放所需功能齐全：字幕、播放列表、章节等
• 支持 Force Touch、画中画（PiP）以及进阶的 Touch Bar 支持
• 可自定义界面，包括多套配色方案与屏幕控制器（OSC）布局位置
• 为音频文件设计的独立音乐模式
• 视频缩略图
• 在线字幕搜索与本地字幕智能匹配
• 无限播放历史记录
• 视频/音频滤镜的可视化、交互式设置
• 键盘、鼠标、触控板与手势操作均可完全自定义
• 面向高级用户的 mpv 配置文件与脚本系统
• 提供命令行工具与浏览器扩展

安装与使用

普通用户可直接从 GitHub Releases 或官网下载安装包；如需尝鲜，可使用 Nightly 下载页的构建版本。

从源码构建时，IINA 依赖 mpv，可以下载官方预编译库，或自行编译。

使用预编译库构建

1. 运行脚本下载预编译库：

./other/download_libs.sh

默认下载 universal 二进制，可用 --arch <ARCH> 指定架构（universal、arm64 或 x86_64）；文件默认 5 个并发并行下载，可用 --parallel <N> 调整。若要构建较旧的 IINA 版本，需要修改脚本中的 DYLIBS_DOWNLOAD_PATH，例如 https://iina.io/dylibs/1.2.0/universal/fileList.txt。

2. 用最新公开版本 Xcode 打开 iina.xcodeproj，使用其他版本可能导致无法构建。

3. 构建项目。

自行编译 mpv

1. 先自行构建 mpv，可使用官方构建脚本 deps-buildscripts 构建 mpv 及所有依赖。
2. 运行 other/parse_doc.rb，该脚本会拉取最新的 mpv 文档并生成 MPVOption.swift、MPVCommand.swift、MPVProperty.swift，将它们从 other/ 复制到 iina/ 覆盖现有文件（仅在更新 libmpv 时需要；若 API 变化，播放器源码可能也需调整）。
3. 将 yt-dlp 链接到 deps/executable：

mkdir -p deps/executable
ln -s $(which yt-dlp) deps/executable/youtube-dl

4. 用最新公开版本 Xcode 打开 iina.xcodeproj。
5. 移除侧边栏 Frameworks 分组中所有 .dylib 引用，并通过右键菜单的 “Add Files to iina...” 将 deps/lib 下的 .dylib 全部加入该分组。
6. 在 iina target 的 “Build Phases” 标签页中，把所有导入的 .dylib 加入 “Copy Dylibs” 阶段。
7. 确认 “Link Binary With Libraries” 阶段包含所需的 .dylib 文件。
8. 构建项目。

插件

IINA 内置插件系统，可在「设置 → 插件」中直接浏览和安装社区插件，插件清单维护在 plugins.json。官方插件包括：

• Online Media（iina/plugin-online-media）：增强在线串流与下载
• OpenSubtitles（iina/plugin-opensub）：搜索与下载字幕
• User Scripts（iina/plugin-userscript）：运行自定义 JavaScript 片段

插件开发文档见 docs.iina.io。

注意事项

• Nightly 构建由 GitHub 针对每次提交自动生成，可能包含 bug 甚至无法使用；遇到问题请提交 issue。
• 构建 IINA 时请务必使用最新公开版本的 Xcode，否则可能构建失败。
• 翻译请前往 IINA 的 Crowdin 页面参与，不要直接向仓库提交 PR，Crowdin 会自动同步译文。
• 项目采用 GPL-3.0 许可证。

---

本作品整理自 GitHub 开源项目 iina/iina，原作者 @iina，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。