Yamby 手机端直接扫描 Emby 媒体库和文件夹

什么是手机端管理员功能

这是 Yamby 相对于 Emby 官方客户端的最大杀手级功能之一——在手机上直接操作 Emby 服务器的媒体库维护，不用打开电脑、登录 Web 管理面板。

能做的事包括：

• 扫描媒体库 / 扫描指定文件夹
• 识别电影和剧集元数据
• 编辑刷新元数据
• 编辑媒体图片

这些功能的实现基于 Emby 服务器提供的完整 REST API，Yamby 把这些 API 封装成手机端易用的界面。

前提条件

手机端管理员功能需要满足：

1. 连接的 Emby 账号具有 管理员权限（普通用户账号看不到管理员选项）
2. Yamby 版本较新（管理员功能在早期版本就已加入）
3. 手机和 Emby 服务器网络连通（同局域网最快，公网也可以）

扫描整个媒体库

入口：媒体库页面 → 点击目标媒体库的名称（不是封面）→ 弹出菜单 → 「扫描媒体库」

扫描流程：

1. Yamby 发送 API 请求到 Emby 服务器，触发该库的全量扫描
2. Emby 服务器遍历库的所有文件夹 → 识别新影片 → 刮削元数据 → 更新数据库
3. 扫描过程在服务器端执行，Yamby 显示扫描进度条
4. 扫描完成后 Yamby 自动刷新海报墙，新入库的影片会出现在列表中

扫描耗时取决于库的大小——几十部影片的库通常几秒完成，几千部的大库可能需要几分钟。扫描进行期间 Yamby 可以后台运行，不影响其他操作。

扫描指定文件夹

Emby 服务器上每个媒体库可能包含多个物理文件夹。有时候只需要扫描某个新增了影片的文件夹，不需要全库扫描。

入口：媒体库 → 长按目标文件夹 → 「扫描此文件夹」

局部扫描比全库扫描快很多，适合日常添加少量新影片时使用。

扫描选项

某些场景需要精细控制扫描行为。长按媒体库名称 → 「高级扫描选项」：

• 强制重新扫描：忽略已有缓存，重新遍历所有文件（耗时更长但更彻底）
• 只扫描新文件：跳过已刮削过的文件（默认值，最快）
• 刷新元数据：扫描完成后对全部条目标记为「需要元数据刷新」，触发重新刮削

与 Emby Web 管理面板的关系

Yamby 的手机端管理员功能完全等价于 Emby Web 管理面板上的对应操作——底层调用的是同一套 Emby Server API。区别只是界面从 PC 浏览器变成了手机触屏。

所有操作都会在 Emby 服务器留下完整的审计日志（谁在什么时候对哪个库执行了什么操作）。多人共享 Emby 服务器时，管理员可以通过服务器日志追溯操作历史。