字幕

設定

字幕語言只要選一次。HolyArrs 會讀取你的檔案已經有的字幕，並列出缺少的部分。

只有擁有者和管理員看得到字幕。變更設定需要 Change settings（變更設定）權限。音樂沒有字幕。

設定你的語言

開啟 Settings > Subtitles（設定 > 字幕）。
在預設語言下，新增你要的每一種語言，例如英文和西班牙文。
為每種語言設定 Hearing-impaired（聽障）和 Forced only（僅強制字幕），請看語言。
按下 Save（儲存）。你應該會看到 Library > Missing subtitles（媒體庫 > 缺少的字幕）被填入內容。HolyArrs 會讀取你所有的檔案，不會詢問任何網站。
如果你有開啟字幕網站，按下 Add a Subtitle site（新增字幕網站），選擇網站，如果它要求就填入 Your account（你的帳號），然後儲存。你應該會馬上看到測試搜尋的結果。

用 Import a library（匯入媒體庫）帶進來的檔案，會用同樣的方式讀取。

開啟 Library > Missing subtitles。每一列是一部缺少字幕的電影或一集，並附上原因（還沒找過、還沒找到，或還沒有超過及格分數的字幕）和下次嘗試的時間。

電影頁面有一張 Subtitles 卡片。影集頁面有一張涵蓋整部影集的卡片。每一個有檔案的集數，在它那一列都有 Subtitles 按鈕。

控制項	作用
Languages（語言）	顯示這個作品想要什麼，以及來源：預設語言、影集，或它自己的設定。Change（變更）會切換成它自己的清單。自己的清單是空的，表示不要字幕。
Look for subtitles（尋找字幕）	立刻搜尋缺少的字幕。
Choose a subtitle（選擇字幕）	列出每個網站的每個結果，附上滿分 100 的分數和符合的項目。Choose（選擇）會儲存它，不管分數多少。
Sync fix（同步修正）	用於 HolyArrs 儲存的字幕。把每一行最多平移 10 分鐘、變更影格率（例如 25 改成 23.976），或兩者都做。舊檔案會移到保留資料夾。
Turn down（棄用）	用於 HolyArrs 儲存的字幕。檔案會移到保留資料夾，這個檔案再也不會選用該字幕，HolyArrs 會另外找一個。

每個字幕會顯示語言、類型（一般、聽障或強制）、來源（影片內、影片旁、網站，或手動選擇）、分數和檔名。發生的所有事情都會顯示在作品 History 的字幕項目下，通知也可以告訴你。

選項	可選項目
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 何時搜尋，以及它用的網站，請看字幕評分與字幕網站。

症狀： 沒有任何項目列為缺少。 原因： 沒有儲存任何語言，或作品的自有清單是空的。 解決方式： 新增一種語言，按下 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 路由。