トラブルシューティング
何も表示されない
- まだ言語を選んでいない:右上に「Subpair: 言語を選んでください」という通知が表示されます。設定を開いて、メイン字幕の言語を選んでください。
- Subpairがオフになっている:ツールバーボタンに「OFF」と表示されます。ボタンをクリックするか、Alt+Shift+Sを押してください。
- Jellyfinサーバーをまだ有効にしていない:Jellyfinのページでブラウザーのツールバーにある Subpair ボタンを一度押すか、設定の「Jellyfinサーバー」にアドレスを追加してください。以前のバージョンのSubpairで許可したサーバーも、もう一度有効にする必要があります。
- インストールまたは更新した直後のNetflix:Netflixのタブを一度再読み込みしてください。
- 動画にメイン字幕の言語のテキスト字幕がない:画像字幕(PGS、VobSub)は読み取れません。ほかのメイン字幕の言語を選ぶか、Jellyfinのアイテムにテキスト字幕ファイルを追加してください。
2行目の字幕が表示されない、または別の言語になる
2行目の字幕には、2行目の字幕の言語のうち、トラックがある最初の言語が使われます。どの言語にもトラックがない場合はメイン字幕を翻訳するため、ブリッジが必要です。歯車メニューの2行目の字幕の行に、何がなぜ表示されているかが示されます。よくある原因は次のとおりです。
- 「翻訳ブリッジが起動していません」:Subpairフォルダーの
start-bridge.cmdをダブルクリックするか、Windowsの起動時に自動で起動するよう設定してください(翻訳を参照)。 - 「翻訳できる翻訳エンジンがありません」:ブリッジの
/healthページで、どの翻訳エンジンが設定済みかを確認できます。 - 設定のブリッジのアドレスが、ブリッジのポートと一致していない。
字幕のタイミングがずれる
歯車メニューの字幕のタイミングで、この動画のメイン字幕全体、または2行目の字幕全体を早めたり遅らせたりできます。字幕ファイルの一部だけがずれている場合は、ファイル自体の修正が必要です。ダウンロードしたファイルが別のリリースに合わせてあったり、そもそも別の話数のものだったりすることがあります。Jellyfinのライブラリなら、別プロジェクトのsubsync-repairが、動画自体のトラックをもとに字幕ファイルをチェックして修正します。2行目のトラックがおかしい場合は、翻訳エンジン、代わりにメイン字幕を翻訳で翻訳に置き換えられます。
ブリッジが起動しない
cannot listen on 127.0.0.1:8765:そのポートですでに別のブリッジが動いています。それを止めるか、BRIDGE_PORTで別のポートを設定してください(設定のアドレスも同じにします)。unknown setting:bridge/config.jsonの設定名にタイプミスがあります。bridge/config.defaults.jsonと見比べてください。- Node.jsが21より古い:最新のバージョンをインストールしてください。
ブリッジのエラーメッセージ
プレーヤーは、ブリッジのエラーをお使いの言語で表示します。対応が必要なものは次のとおりです。
| メッセージ | 対処法 |
|---|---|
| claudeコマンドが実行できませんでした | Claude Codeをインストールしてclaudeを一度実行してログインするか、claude.commandを設定してください |
| Anthropic APIキーがありません | ANTHROPIC_API_KEYまたはapi.keyを設定し、ブリッジを再起動してください |
| OpenAI互換の翻訳エンジンが設定されていません | openai.baseUrlとopenai.modelを設定し、ホスティングサービスならそのキーも設定してください |
| ezTrans XPが見つかりません | eztrans.dirにezTrans XPのフォルダーを設定してください(Windowsのみ) |
| …をcmd.exeで安全に実行できません | claude.commandを.cmdではなく.exeに向けてください |
| 許可されていないオリジン | bridge/config.jsonのallowedOriginsに、いま使っているSubpairが含まれていません。現在のIDを追加して(拡張機能を別のフォルダーから読み込むとIDが変わります)、ブリッジを再起動してください |
ログの場所
- 手動で起動したブリッジ:そのターミナルに出力されます。
- Windowsのスタートアップタスク:
%LOCALAPPDATA%\subpair\bridge.log、または-Logで指定したファイル。 - 拡張機能:NetflixまたはJellyfinのタブで開いたブラウザーの開発者コンソール(行は
[Subpair]で始まります)。
どれにも当てはまらないとき
GitHubでIssueを作成してください。使っているブラウザーとサイト(NetflixまたはJellyfin)、期待した動作と実際に起きたことを書き、あればコンソールの[Subpair]の行やブリッジのログも添えてください。