## setup

两个免费密钥，五分钟搞定。

Name: MediaPorter
Author: MediaPorter

MediaPorter 通过两个第三方服务来丰富你的媒体库：TMDb 提供海报与剧集/电影元数据，OpenSubtitles 提供文件中尚未内嵌的语言字幕。两者都对个人用途免费，只需注册账号。

为什么用自己的密钥：把共享密钥打包进应用，几天内就会被从二进制中提取，紧接着触发限流或被吊销 —— 所有人都用不了。每个用户用自己的密钥，MediaPorter 才能长期可用。
如果跳过：应用仍可同步文件。没有 TMDb —— 使用回退海报和最少元数据。没有 OpenSubtitles —— 只用文件中已内嵌的字幕。
隐私：密钥保存在你的 Mac 上。MediaPorter 直接从你的电脑访问 TMDb 与 OpenSubtitles，不经过我们的服务器。

构建

选择合适的下载版本。

MediaPorter 提供两个 macOS 构建。应用行为相同；区别只在于需要重封装或音频转换时 ffmpeg 从哪里来。

ffmpeg 已包含在 app 包内。这是最简单的选择，不需要 Homebrew，也不需要命令行设置。

下载体积更小。请自行安装 ffmpeg，例如 `brew install ffmpeg`，或让任何兼容的 ffmpeg 二进制出现在 PATH 中。

tmdb

在「分析」阶段用于识别电影、电视剧和动漫，并获取海报以及 TV 应用所需的完整字段集（季、集号、排序标题）。没有它 —— 只能得到生成的回退海报，标题就是文件名。

// TMDb 免费档对个人用途几乎没有上限 —— 即使同步一个很大的库，也碰不到每日下载限制。

opensubtitles

在「分析」阶段用于查找并下载你配置语言（例如 en, ru）的字幕，前提是文件中尚未内嵌。下载的 SRT 会被重新封装到输出文件中，从而在 TV 应用的字幕开关中出现。

在 opensubtitles.com 注册 —— 免费，无需信用卡。
前往 opensubtitles.com/consumers 并点击「New consumer」。名字随便填（例如「MediaPorter on my Mac」）。复制 API 密钥。
在 MediaPorter 中：Settings (⌘,) → Subtitles → 粘贴 API 密钥、opensubtitles.com 账号用户名、密码以及目标语言（例如 en,ru）→ Save。

// 已注册的免费账号每天可下载 20 个字幕 —— 看一部电影或几集很够用，但一次同步 24 集动漫一季就有点吃紧。OpenSubtitles VIP（约每年 $10）会显著提高上限，适合同步大型库。

对已经拖进来的文件夹重新运行「分析」—— MediaPorter 会为之前跳过的文件补全海报与字幕。已在 TV 应用中的项目不会被改动；丰富只应用于新文件或重新分析的文件。