Yamby 字幕不显示问题的排查步骤

问题分类

字幕不显示的表现形式不同，对应不同的排查方向：

所有视频都不显示字幕：全局设置问题
部分视频有字幕，部分没有：个别视频的字幕源问题
内嵌字幕不出来，外挂能：播放器 / 格式兼容
外挂字幕识别不到：文件命名 / Emby 服务器配置

情况一：全局都没字幕

排查：

1. 播放器的字幕开关

播放界面 → 唤起控制栏 → 点击字幕图标（CC）→ 确认没有选「关闭」。这是最常见的原因。

2. 默认字幕语言设置

设置 → 播放器 → 字幕 → 默认字幕语言。如果设成了某个不常用的语言（如芬兰语），Emby 服务器返回的中文字幕轨会被忽略（不匹配默认语言）。改成「中文（简体）」或「自动」。

3. 强制使用字幕轨道

设置 → 播放器 → 字幕 → 「强制字幕轨」。开启后 Yamby 会忽略语言偏好，强制使用当前视频的第一个字幕轨。如果这个选项开了，字幕应该能出来。

情况二：个别视频没字幕

排查：

1. 视频本身有没有字幕轨

用 VLC 或 MediaInfo 打开源视频文件，检查容器内是否内嵌了字幕轨道（MKV 支持多轨内嵌字幕，MP4 一般没有内嵌）。如果源视频本身就没有字幕轨，Yamby 当然也放不出来。

2. Emby 服务器刮削是否正确关联字幕

Emby Web 面板 → 编辑该影片 → 字幕标签页。能看到字幕条目 → 服务器端正常；看不到 → Emby 没识别到，先修服务器端。

3. 外挂字幕文件是否存在且命名正确

外挂字幕文件应该和视频文件同目录、文件名一致（仅扩展名不同）。例如：

Movie.2024.mkv
Movie.2024.zh-CN.ass  ← 正确
Movie.2024.ass          ← 正确（无语言标记也能识别）
subs/Movie.2024.srt     ← 错误（不在同目录）
Movie.2024最终版.ass    ← 错误（文件名不一致）

情况三：ASS/SSA 字幕渲染错乱

排查：

1. 是否启用了 MPV 内核

ASS/SSA 特效字幕只有在 MPV 内核下才能完美渲染。如果用的是系统播放器，字幕动画丢失、位置偏移是正常现象。设置 → 播放器 → 默认播放器 → 切到 MPV。

2. 字幕文件本身有问题

ASS/SSA 字幕文件可能被截断、编码错误、或作者脚本有 bug。用 VLC 播放同一个文件验证——VLC 能正常渲染 → Yamby 也应该能；VLC 也乱 → 字幕文件有问题。

情况四：Emby 服务器有字幕但 Yamby 看不到

排查：

1. 清除 Yamby 缓存

设置 → 通用 → 清除图片/元数据缓存。然后重新进入该影片详情页，强制 Yamby 从服务器拉取最新字幕信息。

2. 权限问题

当前登录的 Emby 账号是否有该影片的观看权限。如果管理员刚刚添加了新字幕但没有同步到普通用户权限，Yamby 可能看不到。

3. 重启 Yamby + 重连服务器

有时候 Yamby 内部缓存状态异常。完全关闭 Yamby → 重新打开 → 重新连接服务器。