ffinly / emby-companion

# Emby 观影助手
**简体中文** | 繁體中文 | English
---
**更优雅地探索、订阅与播放你的 Emby 媒体库**
Emby 观影助手是一款 macOS 观影工具。从榜单、厂牌和喜欢的演员、导演出发，找到下一部想看的电影或剧集；连接 Emby 后，直接核对入库与缺集，再用熟悉的播放器继续观看，进度自动同步回媒体库。
**没有 Emby 服务器也可以用。** 配置自己的 TMDB API Key，即可独立浏览榜单、探索 48 个厂牌与平台、搜索影视和人物，查看评分与简介。Emby 与订阅服务都可以按需连接。
下载最新版 · 版本记录 · 反馈问题
本仓库提供安装包、使用说明与问题反馈；应用闭源，不提供影视资源、服务器账号或第三方服务凭证。
## 界面预览
截图展示 macOS 26 及以上的 Liquid Glass 外观，并随页面的浅色／深色主题自动切换；较早版本使用经典样式。
*首页厂牌探索。连接并同步 Emby 后可显示媒体库；有可续播记录时显示“继续观看”。*
*浏览影视榜单，筛选作品并查看 Emby 入库状态。*
## 主要功能
### 发现影视
- **榜单发现**：浏览 IMDb、豆瓣、TMDB、影展与奖项等榜单，查看排名和入库状态；从作品详情查看收录它的榜单。预置榜单随 emby-collection-sync 更新，也可通过“添加 TMDB 片单”导入在线片单。
- **厂牌探索**：按电影厂牌、动画厂牌、欧美剧集和亚洲剧集浏览 48 个厂牌与平台的作品，支持作品筛选，展示入库、观看和订阅状态。
- **搜索与人物作品**：按片名、人物、合集名称或编号搜索，支持 TMDB／IMDb 编号及作品链接；片名留空可浏览所选地区的热门影视。浏览简介、评分、演职人员与人物作品集，详情页可跳转豆瓣、IMDb 和 TMDB。
- **核心榜单入库率**：默认统计第一至第三梯队，支持按级别选择、单独勾选或排除榜单，保存后更新去重统计。首页的全部片单作品数与已入库数量仍按所有片单统计。另可设置首页默认打开的榜单。
### 媒体库与播放
- **首页与继续观看**：首页浏览 Emby 媒体库与继续观看，使用默认播放器和线路续播对应版本，支持查看全部。
- **媒体库与合集**：浏览 Emby 电影、剧集、合集、季度与分集，查看可播放版本，管理观看状态；可隐藏观看记录与进度，也可单独隐藏首页媒体库或“继续观看”。
- **入库与缺集核对**：根据已同步的 Emby 数据展示入库状态，并按季度对照 TMDB 集数与 Emby 实际集号。尚未核对或总集数未知时单独提示。缺集核对无需配置 MoviePilot，订阅时才需要配置。
- **多线路与外部播放**：同一 Emby 服务器可分别配置资料同步与播放线路，选择媒体版本后调用 SenPlayer、Infuse 或 VidHub，支持续播与观看进度回传。分段电影以 `PART 1`、`DISC 2` 等标签标识，同组文件按数字或字母顺序排列；分段文件进度各自独立，普通完整版本之间仍同步进度。
### 订阅、缓存与备份
- **MoviePilot 联动**：订阅未入库电影或缺集季度，自动跳过已入库、集数已齐及已有订阅的内容；支持搜索和批量管理订阅。MoviePilot 为可选服务，下载与入库由其处理。
- **资料与图片缓存**：完整同步媒体库后自动获取所选语言的 TMDB 影视、人物及整季分集资料，图片按需加载；可查看同步结果、重试失败项，并管理缓存或重建本地搜索索引。
- **备份与恢复**：按需选择配置、片单、缓存及使用偏好，导出加密备份并选择恢复范围。
## 语言与显示
在“连接与设置 → 语言”分别设置界面、预置片单、TMDB 元数据及海报语言。界面支持跟随系统、简体中文、繁体中文与英文；片单和元数据可跟随界面，也可独立选择三种语言。
榜单同步会读取并缓存上游的三语名称，切换已有名称无需重新下载。影视与人物资料、分集信息及同步历史中的作品名称跟随 **TMDB 元数据语言**，不同语言资料分别缓存；缺少对应资料时保留可用的 Emby 内容。资料刷新只更新本机，不改写服务器元数据。
海报可选原语言、中文或英文。已有图片可复用，未缓存图片仍需联网。媒体库名称支持预置中英映射与自定义显示名称，留空保留原名称，仅影响本应用。
在“连接与设置 → 外观”选择外观模式（自动／浅色／深色，默认跟随系统）、调整海报大小，并在支持的系统上切换 Liquid Glass 与经典样式。
## 下载与初次使用
需要 **macOS 14 或更高版本**，通用安装包支持 **Apple Silicon 与 Intel**。从 最新 Release 下载 DMG，将 **Emby Companion.app** 拖入“应用程序”；替换旧版前先退出应用。
### 首次打开：macOS 安全提示
当前安装包使用本地签名，尚未经过 Apple Developer ID 签名和公证。确认来源为本仓库 Releases 后，先尝试打开一次；如被系统阻止，前往 **系统设置 → 隐私与安全性 → 仍要打开**，按提示确认。参见 Apple 官方说明。
 备用方法：通过终端处理首次打开限制 
仅在确认安装包来自本仓库 Releases，并已将应用拖入“应用程序”后使用：
 [code] 
若提示权限不足，可在命令前加上 `sudo`。
此命令移除应用的下载隔离属性，不能修复真正损坏的文件。若系统明确提示检测到恶意软件，请停止打开并反馈具体提示。
后续安装包的签名状态以 Release 说明为准。
### 连接服务
1. 如需使用媒体库功能，在“连接与设置”填写 Emby 地址并登录。
2. 在 TMDB API 设置 申请自己的 API Key，阅读 API 使用条款，再填入应用；需要时可配置 HTTP／SOCKS 代理，用于 TMDB 资料、图片、榜单及软件更新（GitHub）；Emby 与 MoviePilot 直连。
3. 在首页同步榜单；连接 Emby 后，再执行“完整同步媒体库”。
4. 需要播放时安装外部播放器；需要订阅时，再填写 MoviePilot 服务地址与 API 令牌；令牌可从 MoviePilot“设定 → 系统 → 基础设置”复制。
TMDB 与 MoviePilot 支持独立“清除配置”；清除 TMDB API 配置时保留代理。退出 Emby 登录会清空地址、账号、令牌及全部线路配置。
## 线路与播放器
登录后，在“连接与设置 → Emby → 多线路管理”添加和管理线路。同一服务器与账号的多条线路共用媒体库缓存，可分别指定同步主线路与默认播放线路，也可通过 `ecplayer://importserver` 链接预览并导入配置。格式见应用内“Emby 线路 → 通过链接导入 Emby”。
| 外部播放器 | 支持关闭播放窗口后回传进度的版本 |
| --- | --- |
| SenPlayer | 6.1.1 及以上 |
| Infuse | 8.4.7 及以上 |
| VidHub | 2.3.5 及以上 |
播放进度自