IINA

IINA 是什么

IINA 是一款面向 macOS 的现代视频播放器，使用 Swift 编写，播放内核基于 mpv。它把 mpv 强大的解码与格式兼容能力，与 macOS 原生的界面和交互方式结合起来，目标是成为 Mac 上体验最接近系统原生、同时功能足够强大的开源播放器。

项目采用 GPL-3.0 协议，在 GitHub 上已有近 4.7 万 Star，长期保持活跃开发。

主要特性

• 解码能力：基于 mpv，在 macOS 上提供出色的视频与音频解码表现。
• 现代系统设计：面向 macOS 11.0 及以上版本设计，贴合系统交互习惯。
• 完整播放功能：字幕、播放列表、章节、缩略图、无限播放历史等。
• 原生交互：支持 Force Touch、画中画（PiP）以及进阶 Touch Bar 控制。
• 可定制界面：多种配色方案，屏幕控制器（OSC）布局位置可调整。
• 音乐模式：为纯音频文件提供独立的播放界面。
• 字幕能力：在线字幕搜索与本地字幕智能匹配。
• 控制方式：键盘、鼠标、触控板与手势均可自定义。
• 进阶能力：兼容 mpv 配置文件与脚本系统，并提供命令行工具和浏览器扩展。

插件生态

IINA 提供插件机制，官方维护了若干插件，例如：

• Online Media：增强在线流媒体播放与下载。
• OpenSubtitles：搜索并下载字幕。
• User Scripts：运行自定义 JavaScript 片段。

社区插件可在应用内「设置 → 插件」的插件商店中浏览安装，插件列表维护在仓库的 plugins.json 中。开发者可参考官方插件文档编写自己的插件。

下载与构建

普通用户可直接从 GitHub Releases 或官网获取稳定版与测试版；想尝鲜可下载 nightly 构建，但夜间版本由每次提交自动生成，可能不稳定。

如需从源码构建，大致流程为：

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

./other/download_libs.sh

2. 使用最新公开版本的 Xcode 打开 iina.xcodeproj 并构建。

也可以自行编译 mpv 及其依赖，再按仓库说明生成并替换 MPVOption.swift、MPVCommand.swift、MPVProperty.swift 等文件，并配置动态库链接。具体步骤以仓库文档为准。

参与贡献

IINA 欢迎各类贡献：提交 Bug 报告与功能建议、贡献代码、参与翻译。翻译通过 Crowdin 平台进行，新译文会自动同步回仓库，无需直接向仓库提交翻译 PR。代码贡献前建议先阅读 CONTRIBUTING.md，了解项目的贡献流程与代码结构。

适合谁

• 希望获得比系统播放器更强解码与字幕能力的 Mac 用户；
• 需要画中画、Touch Bar、手势控制等原生体验的用户；
• 想通过插件或脚本扩展播放器能力的进阶用户；
• 希望学习 Swift + AppKit 桌面应用架构与 mpv 集成的开发者。