字幕

字幕语言只用选一次。HolyArrs 会读出你的文件里已经有什么，并列出缺的。

只有管理人员能看到字幕。改设置需要 Change settings（更改设置）权限。音乐没有字幕。

注意

字幕站和字幕搜索在第一个正式版里暂未开放。除非打开 subtitle_sites 开关，否则它们一直隐藏，参见暂未开放的功能。语言和缺失字幕列表不需要这个开关也能用。

设置你的语言

1. 打开 Settings > Subtitles（设置 > 字幕）。
2. 在默认语言下面，把你要的语言逐个加上，比如英语和西班牙语。
3. 给每种语言设置 Hearing-impaired（听障字幕）和 Forced only（仅强制字幕）（参见语言）。
4. 点击 Save（保存）。你应该会看到 Library > Missing subtitles（媒体库 > 缺失字幕）里有了内容。HolyArrs 会读你所有的文件，不查询任何字幕站。
5. 如果你这里开放了字幕站，点击 Add a Subtitle site（添加字幕站），选好字幕站，要求填的话就填上 Your account（你的账户），然后保存。你应该马上就会看到一次测试搜索的结果。

用 Import a library（导入媒体库）带进来的文件也是这样读的。

看缺了什么

打开 Library > Missing subtitles。每一行是一部缺字幕的电影或一集，附带原因（还没找过、还没找到，或者还没有超过及格分的）和下次尝试的时间。

• 可以按语言、按电影或集、按条目筛选。页面地址会记住你的筛选条件，所以可以把某个视图存成书签。
• Search all（全部搜索）会搜索筛选后列表里的每一行，并显示进度。
• 某一行上的 Search（搜索）只搜索那一个文件。

修正一部电影或一集

电影页面上有一张 Subtitles（字幕）卡片。剧集页面上有一张管整部剧集的。每个有文件的集，在它那一行上都有一个 Subtitles 按钮。

控件	作用
Languages（语言）	显示这个条目要哪些语言，以及这个设定来自哪里：默认语言、所属剧集，还是它自己的。Change（更改）会切换成它自己的列表。自己的列表为空，就表示不要字幕。
Look for subtitles（找字幕）	搜索现在缺的字幕。
Choose a subtitle（手动选字幕）	列出每个字幕站的每条结果，附带满分 100 的分数和匹配上的项目。Choose（选择）会保存它，分数多少都行。
Sync fix（同步修正）	用于 HolyArrs 保存的字幕。把每一行整体挪动最多 10 分钟，或改帧率（比如 25 改成 23.976），或两者都做。旧文件进暂存文件夹。
Turn down（排除）	用于 HolyArrs 保存的字幕。文件进暂存文件夹，这条字幕再也不会被选给这个文件，HolyArrs 会另找一条。

每条字幕都会显示语言、类型（普通、听障或强制）、出处（视频内嵌、放在视频旁边、来自字幕站，或手动选的）、分数和文件名。发生的每件事都会显示在条目的 History（历史记录）里的 Subtitles 下面，通知也可以告诉你。

选项

语言

选项	可选值
Hearing-impaired	Normal（普通，听障字幕也算数）、Hearing-impaired only（仅听障字幕，会一直等到带声音描述的字幕）或 Either（都可以）。
Forced only	只有外语对白和画面文字的那几行。

最多 10 种语言。同一种语言只有在一个是完整字幕、另一个是仅强制字幕时才能出现两次。一种语言都没设置的话，HolyArrs 什么都不找。

字幕存在哪里

放在视频旁边：视频的名称、语言，然后是 .hi（或 .cc、.sdh）或 .forced，最后是格式。

Movie (2020).en.srt
Movie (2020).es.hi.srt
Movie (2020).fr.forced.ass

• HolyArrs 绝不会覆盖不是它保存的字幕文件。那个文件算作已有。
• 被 HolyArrs 替换的字幕会先进暂存文件夹。
• Rename files（重命名文件）会把字幕和视频一起移动。如果新名称已被占用，那条字幕留在原处并说明原因。
• 连同文件一起删除一个条目时，它的字幕也会进暂存文件夹。

评分怎么算、HolyArrs 什么时候搜索、用哪些字幕站，都在字幕评分与字幕站里。

如果不成功

现象：缺失列表里什么都没有。 原因：没有保存任何语言，或者这个条目自己的列表是空的。 解决办法：加一种语言，然后点击 Save。

现象：你看不到字幕站或 Look for subtitles。 原因：它们暂未开放，参见暂未开放的功能。

现象：字幕对不上时间。 解决办法：用 Sync fix，或者把及格分调高，只保存更接近的匹配。HolyArrs 不会靠听声音来对齐字幕。

现象：字幕不对。 解决办法：用 Turn down。

现象：已有的字幕没有被替换。 原因：HolyArrs 绝不会覆盖不是它保存的字幕文件。

进阶

设置项参考

设置项	默认	范围
默认语言	无	最多 10 种
Hearing-impaired 文件后缀	.hi	.hi、.cc、.sdh
Count subtitles inside the video（把视频内嵌的字幕算上）	开	开或关
Leave out picture subtitles（不算图形字幕）	关	开或关

评分、计划和同步修正的设置项在字幕评分与字幕站里。

API

所有字幕路由都在 http://your-server:6262/api/v1/openapi.json 里，位于 Subtitles 标签下。搜索的回答里是对应后台任务的 id，脚本可以据此跟踪它们。参见 API 路由。

相关页面

• 字幕评分与字幕站
• 音频版本
• 暂未开放的功能