Jellyfinは、サーバーを権威ある情報源として維持しながら、アドオンによる認証、メタデータの同期、更新の受信、各再生リクエストの解決を通じてKodiを連携させます。
Kodiボックスは、Jellyfinがユーザー、視聴済み状態、メタデータ、アクセスルールを引き続き管理しているにもかかわらず、ネイティブなローカルライブラリのように感じられます。この体験は、2つの異なる統合モデルによって実現されます。Jellyfin for Kodiは選択したカタログデータをKodiにコピーする一方、JellyConはより動的にサーバーへクエリを送信します。その後の再生はJellyfin経由で行うことも、変換されたネットワークパスを使用することもでき、整合性とネットワーク要件の両方に影響します。
アイデンティティと状態のソースはサーバーであり続ける
KodiはJellyfinユーザーとして認証し、そのアカウントに許可されたライブラリと操作だけを受け取ります。クライアントのインターフェースがKodiネイティブであっても、メディアの識別、メタデータの判断、視聴進捗、セッションの可視性は引き続きサーバーが管理します。
Kodiのメタデータ同期についてのユーザー向けの説明では、完全同期型のアドオンと、より軽量でアドオンらしいブラウジングを提供するJellyConの違いが示されています。違いは、カタログの状態をどこに実体化するかにあります。
この権限分担により、Kodiが独立した2つ目のメディアマネージャーになるのを防げますが、同時に同期の義務が生じます。Kodiのローカル行は、安定したJellyfinアイテムの識別子に継続して対応していなければなりません。
同期によってサーバーの変更がローカル行に変換される
Jellyfin for Kodiは、まず選択したメタデータをKodiのローカルデータベースにコピーし、その後、起動時およびリアルタイムの更新機構を使って変更を一致させます。キューモデルにより、Kodiはライブラリ全体を毎回再構築するのではなく、最後に認識した位置以降の変更を要求できます。
Kodi統合の実用的な事例では、同期後にライブラリデータがKodiのネイティブビューに表示されることが示されています。このローカルへの実体化があるため、サーバーがLAN上のリモートにあってもブラウジングがすぐに反応するように感じられます。
境界となるのはデータベースの所有権です。同じKodiデータベースを変更する他のツールが、同期された表現と競合する可能性があります。ローカルでの高速なブラウジングは、Kodiが権威あるメタデータソースになったことを意味しません。
再生モードによってサーバーURLとネイティブパスが選択される
アドオンモードでは、Jellyfinが再生を解決し、通常のストリーミング判断を適用できます。ネイティブモードでは、パス置換によってサーバーのファイルシステム上の見え方がクライアントから到達可能なネットワーク上の場所に変換された後、KodiがSMBまたはNFSのパスに直接アクセスします。
ネイティブパス再生に関する議論では、重要な仕組みが強調されています。メタデータの連携を維持したまま、生のメディアがJellyfinの配信経路を迂回できるのです。これによりサーバーによる仲介を減らせる一方、共有権限とパスの一貫性が必要になります。
したがって、ネイティブモードが常に高速とは限りません。Kodiが同じファイルへ確実にアクセスでき、なおかつ自分でデコードできる場合にのみ有効です。リモートクライアントや一貫性のないマウントでは、通常、サーバー経由のパスのほうが適しています。
スプリットブレインを防ぐ連携チェックリスト
アイデンティティ、パス、または更新位置がずれると、連携は失敗します。同期状態をリセットせずにKodiを再構築したり、パス置換を変更せずにJellyfinのパスを変更したり、関係のないKodiデータベース書き込みツールを併用したりすると、両方のアプリケーションが起動し続けていても、古い行が残ることがあります。
より広いクライアント能力モデルでは、メタデータの同期後もKodiの再生が他のクライアントと異なる場合がある理由を説明しています。Kodiのデコーダー対応と選択されたパスは、引き続き別の変数です。別の現場レポートでも、表示された症状だけでボトルネックを判断せず、Kodiの起動時同期を使用することが支持されています。
変更後は、4つの契約を確認してください。Kodiのプロファイルが意図したJellyfinユーザーに対応していること、新しいアイテムが起動時またはリアルタイム同期で追加されること、視聴済み状態がサーバーに戻ること、そしてテストファイル1つがフォールバックなしで選択したアドオンまたはネイティブパス経由で解決されることです。
テック&AIハブ
もっと読む

JellyfinのパフォーマンスがLAN接続とリモート接続で異なる理由
サーバーは同一でも、リモートアクセスによってネットワーク帯域の予算が変わり、配信方法やトランスコードの判断が異なることがよくあります。

JellyfinはCGNATまたは二重NAT環境でも安定して動作しますか?
メディアサーバーは引き続き正常に機能しています。未解決の問題は、十分な持続スループットを確保しながら、アドレス変換を介して到達可能で安全な経路を構築することです。

ネットワーク遅延が字幕付きJellyfin HDR再生に与える影響
HDR字幕の再生では、ネットワーク配信と変換処理のタイミングが連動するため、ジッターや往復遅延によって、平均帯域幅では見えない停止が露呈することがあります。

