Kodi 命名ガイド：映画、テレビ番組、アニメ、音楽、NFOファイル (2026年版)

Kodi命名の基本

Kodiのスキャン方法には、PlexやJellyfinとは大きく異なる3つのコンセプトがあり、ここで個別に説明する価値があります。このセクションをスキップすると、ライブラリに合わないscraperの選択、コンテンツタイプの誤設定、そしてスキャン結果を上書きしてしまう予期せぬNFOファイルという、同じ3つの失敗を繰り返すことになるでしょう。

AgentではなくScraper

Plexには「agent」、Jellyfinには「metadata provider」があるのに対し、Kodiには「scraper」があります。これは特定のデータベースに問い合わせる、コミュニティによって維持されているアドオンです。デフォルトでは、映画用にはThe Movie Database scraper、テレビ番組用にはThe Movie Database scraperまたはThe TVDB scraper、音楽用にはUniversal Album Scraperが使われます。アニメは大きな例外で、Kodiには組み込みのアニメ用scraperがないため、ユーザーはAniDBと連携するためにHama（Plexで使われているものと同じ）のようなコミュニティ製アドオンをインストールします。 Scraperの選択はライブラリ単位ではなく、ソースごとに行います。Kodiのファイルブラウザでビデオソースを開き、編集画面で「コンテンツ設定」を選んでscraperを割り当てます。同じソースでも、同一ネットワーク上の異なるKodiデバイスで別々のアドオンによってスクレイピングされることがあります。これが、「自分のKodiではうまくいくのに、友人のKodiではうまくいかない」という状況がよく起こる理由の一つです。

ライブラリソースとコンテンツタイプ

Kodiのライブラリは、手動で追加する「ソース」（フォルダ、ネットワーク共有、リモートパス）から構築されます。ソースを追加する際、Kodiにそのコンテンツの種類（ムービー、TV番組、ミュージックビデオ、ミュージック、なし）と、そのコンテンツに使用するscraperを伝えます。1つのソースに複数のコンテンツタイプを混在させることは、ファイルが一致しない一般的な原因です。例えば、ムービーとTV番組の両方を含むフォルダは、どちらか一方としてしかscrapeできません。 解決策は、混在したコンテンツを別々のトップレベルフォルダに分割し、それぞれを独自のソースとして、独自のコンテンツタイプを設定することです。これはPlexのフォルダごとのライブラリ検出よりも厳格ですが、一度構造を決めれば、より予測可能になります。

失敗の90%を防ぐための4つのルール

Kodiのスキャン失敗の大部分を防ぐ4つのルールです： ルール1 — 1つのソースにつき1つのコンテンツタイプ。Kodiが「ムービー」としてscrapeする1つのフォルダに、ムービーとTV番組を混在させないでください。 ルール2 — 最初のスキャンの前にコンテンツタイプとscraperを設定します。後で変更すると「更新」が必要になり、古い誤った一致をクリーンアップするためにデータベースの完全なワイプが必要になることもあります。 ルール3 — TVエピソードには、小文字でゼロ埋めしたsXXeYYを使用します。KodiはPlexよりも多くのバリエーションを受け入れますが、予測可能なパターンを使用することでscraperのエッジケースを回避できます。 ルール4 — scraperが特定のアイテムで繰り返し失敗する場合は、その横にNFOファイルを配置します。NFOファイルはscraperを完全に上書きします。これはKodiの緊急回避策です。

Need it from zero? 手順を追った解説.

Kodi向けのムービーの命名規則

Kodiは、ムービー用に2つの有効なレイアウト（ムービーごとのフォルダ形式とフラット形式）を受け入れます。PlexやJellyfinと同様の理由（特典映像、ポスター、NFOファイル）からフォルダ形式が推奨されます。さらに、Kodi固有の機能として、PlexやJellyfinではネイティブに扱えないスタックされた複数パートのムービーをKodiはネイティブに処理できます。

推奨されるフォルダレイアウト

推奨されるフォルダレイアウトは次のとおりです：

Movies/
├── Blade Runner (1982)/
│   ├── Blade Runner (1982).mkv
│   ├── Blade Runner (1982).en.srt
│   ├── movie.nfo
│   ├── poster.jpg
│   └── fanart.jpg
├── Dune (2021)/
│   └── Dune (2021).mkv
└── The Matrix (1999)/
    └── The Matrix (1999).mkv

ファイル名はフォルダ名と一致させます。アートワークファイルには、Kodiのローカルアートワーク名（poster.jpg, fanart.jpg, clearart.png, landscape.jpg）を使用します。字幕は「Title (Year).en.srt」や「.fr.srt」などの規則に従います。Kodiはドットで区切られた接尾辞から言語コードを読み取ります。

(Year) の接尾辞は省略できません

PlexやJellyfinと同様の理由から、括弧で囲んだ年は必須です。TheMovieDBは同名のタイトルを人気順で返すため、Kodiが誤った作品を自動的に選択してしまう可能性があります。フォーマットは「Title (YYYY)」です。角括弧 [YYYY]、ドット区切りの Title.YYYY、年のみの表記は一部のscraperでは機能しますが、他では失敗することがあります。丸括弧 () が最も確実です。 TMDBに全く存在しないムービー（希少なアートハウス作品や地域限定リリースなど）の場合、手動でTMDB IDを指定したNFOファイルが唯一の確実な修正方法です。下記のNFOのセクションを参照してください。

スタックされた複数パートのムービー（Kodi限定）

Kodiは、別々のファイルとして保存された複数パートのムービーをネイティブにサポートしています。これはDVDリッピング時代からの機能ですが、ディスクごとに分割された非常に長い映画（『ロード・オブ・ザ・リング エクステンデッド・エディション』、『ワンス・アポン・ア・タイム・イン・アメリカ』など）に今でも役立ちます。cd1 / cd2 / partN / dvdN の接尾辞パターンを使用します：

Movies/
└── Lord of the Rings - The Fellowship of the Ring (2001)/
    ├── Lord of the Rings - The Fellowship of the Ring (2001) - cd1.mkv
    └── Lord of the Rings - The Fellowship of the Ring (2001) - cd2.mkv

Kodiはこれらを1つの映画として連続再生し、ライブラリに1つのエントリーとしてスクレイピングします。マッチングパターンは大文字と小文字を区別せず、cd, part, dvd, ptなどのいくつかの形式に対応していますが、cd1/cd2が最も安全で、ドキュメントも豊富な形式です。

同一映画の複数バージョン

Kodiには、PlexやJellyfinが提供するような統合された複数バージョン機能がありません。1080p版と4K版を1つのライブラリエントリーに保存し、Kodiにクライアントに適したバージョンを選ばせることはできません。各ファイルがそれぞれ独立したライブラリエントリーになります。2つの回避策があります: 方法1 — Kodiのライブラリには映画ごとに1つのバージョンだけを保持し、他のバージョンはスクレイピング対象のソース外に保存します。他の画質が必要な場合は、ライブラリソースを手動で切り替えます。 方法2 — 2つのソースを持つ2つのライブラリ（Movies-1080p, Movies-4K）に分割します。Kodiのプロファイルやスキンのショートカットを使って切り替えます。手間はかかりますが、これにより全てのバージョンを同じKodiインストール内に共存させることができます。 複数バージョンの管理がワークフローの中心である場合、この点においてはPlexやJellyfinの方が客観的に優れていると言えます。

映画セットとコレクション

Kodiは映画セット（「コレクション」とも呼ばれます）に対応しています。これにより、「スター・ウォーズ」や「マーベル・シネマティック・ユニバース」、「ロード・オブ・ザ・リング」といったシリーズの映画を、1つの閲覧可能なコレクションノードにまとめることができます。セットは、TMDBのコレクションデータに基づいて、該当する映画に対して自動的に作成されます。ファイル名の変更は不要です。KodiはスクレイピングしたTMDBのメタデータからコレクションIDを読み取ります。 カスタムセット（TMDBに存在しない独自のグルーピング）を作成する場合は、映画階層にNFOファイルを使用し、<set>タグでカスタムセット名を指定します。

スクレイピング失敗の主な原因となる4つの間違い

1. ソースのコンテンツタイプが「None」または間違ったタイプに設定されている。コンテンツタイプが指定されていないと、Kodiはそれを映画としてスキャンしません。 2. 公開年がない、または角括弧で囲まれている。「Inception 2010.mkv」は偶然マッチすることがありますが、「Inception [2010].mkv」はTMDB scraperで失敗します。 3. 映画ファイルがフォルダなしでソースのルートに置かれている。マッチングは機能しますが、アートワーク、NFO、分割ファイル機能が壊れます。 4. 以前の間違ったスクレイピングによる古いエントリーが残っている。ファイル名を修正しても、Kodiは古い間違った情報を表示し続けます。解決策: ライブラリのコンテキストメニュー → 「Clean library」→ 再スキャン。

完全な例

Movies/
├── The Matrix (1999)/
│   ├── The Matrix (1999).mkv
│   ├── movie.nfo
│   └── fanart.jpg
├── Lord of the Rings - The Fellowship of the Ring (2001)/
│   ├── Lord of the Rings - The Fellowship of the Ring (2001) - cd1.mkv
│   └── Lord of the Rings - The Fellowship of the Ring (2001) - cd2.mkv
├── Dune (2021)/
│   └── Dune (2021).mkv
└── 1917 (2019)/
    └── 1917 (2019).mkv

Compare to Plexでの同等の設定.

Kodi向けのTV番組の命名規則

TV番組は、Kodiの柔軟性が最も活かされる分野です。複数の有効なファイル名パターンが受け入れられ、scraperは多少の違いにも寛容です。その代わり、何かがマッチしない場合、原因がすぐには分からないことがよくあります。このセクションでは、安全な命名パターンと、KodiがPlexやJellyfinと異なる点について説明します。

フォルダ構成

標準的な2階層の構成です: 番組フォルダ、その中にシーズンごとのサブフォルダを配置します。

TV Shows/
├── Breaking Bad (2008)/
│   ├── tvshow.nfo
│   ├── poster.jpg
│   ├── Season 01/
│   │   ├── Breaking Bad - s01e01 - Pilot.mkv
│   │   └── Breaking Bad - s01e02 - Cat's in the Bag.mkv
│   └── Season 02/
│       └── Breaking Bad - s02e01.mkv
└── The Office (2005)/
    └── Season 03/
        └── The Office - s03e12.mkv

番組フォルダー名は「Title (Year)」です。年はリメイク作品を区別するために使います (例: The Office UK 2001 vs US 2005、House of Cards UK 1990 vs US 2013)。シーズンフォルダーは、2桁のゼロ埋めをした「Season XX」、またはスペシャル用の「Season 0」(もしくは「Season 00」)にします。Kodiは「Season 0」と「Season 00」の両方に対応していますが、どちらか一方に決めて一貫性を保つようにしましょう。 Plexの「Specials」というフォルダー名の慣習とは異なり、Kodiは「Specials」というフォルダー名を文字通りには認識しません。必ず Season 0 または Season 00 を使用してください。

エピソードのファイル名形式

Kodiが推奨するエピソードのファイル名パターンは次の通りです: Show Name - sXXeYY - Episode Title.ext 小文字、2桁のゼロ埋め数字、そして読みやすさのための任意のエピソードタイトルを使用します。Kodiは、大文字 (SXXEYY)、Show.S01E01、Show 1x01、Show 101など、他のいくつかのバリエーションも受け付けますが、小文字でダッシュ区切りの形式が、様々なscraperで最も確実に機能します。 ファイル名に含まれるエピソードタイトルは、あくまで人間が読みやすくするためのものです。Kodiのscraperは、TheTVDBやTheMovieDBから取得した公式タイトルで上書きします。scraperが提供したタイトルが間違っている場合は、KodiのGUI (エピソードを右クリック → 「情報」→「編集」) またはNFOファイル (後述) を使って編集してください。

Season 0 内のスペシャル

スペシャル、OVA、パイロット版、舞台裏映像、ボーナスコンテンツは「Season 0」(または「Season 00」— Kodiは両者を同じように扱います) に入れます。フォルダー内では、Show - s00e01.mkv, Show - s00e02.mkv のように連番を使用します。 この番号順は、その番組のTheTVDBのスペシャルリストと一致させる必要があります。TheTVDBのコミュニティは、これらを特定の順序 (多くは放送日に基づく) で管理しており、Kodiはその順序に従うことを想定しています。KodiのUIでスペシャルの順序がバラバラに表示される場合は、TheTVDBでその番組のスペシャルタブを確認し、s00eYYの番号をそれに合わせて並べ替えてください。

複数エピソードファイル

1つのファイルに2つのエピソードが含まれる場合:

Breaking Bad - s05e15-e16 - Granite State + Felina.mkv

Kodiは、メタデータ上で両方のエピソードにマッピングされる、再生可能な単一のアイテムを作成します。範囲形式 (e15-e16) の方がすっきりしていますが、代替形式 (s05e15-s05e16) も機能します。どちらの形式も、必要であれば3つや4つのエピソード (e15-e16-e17) に拡張できますが、実際には稀です。

デイリー番組 (日付ベース)

従来のシーズン/エピソード番号がないデイリー番組 (トークショー、ニュースなど) は、YYYY-MM-DD の日付形式を使用します:

The Daily Show (1996)/
└── Season 29/
    └── The Daily Show - 2024-03-15.mkv

KodiのTheTVDB scraperは、ファイル名の日付をデイリー番組の日付インデックスと照合します。ソースがTheMovieDBではなくTheTVDB scraperを使用していることを確認してください。TheMovieDBのデイリー番組サポートは限定的です。

完全な例

TV Shows/
├── Breaking Bad (2008)/
│   ├── tvshow.nfo
│   ├── Season 01/
│   │   ├── Breaking Bad - s01e01 - Pilot.mkv
│   │   └── Breaking Bad - s01e02 - Cat's in the Bag.mkv
│   ├── Season 05/
│   │   └── Breaking Bad - s05e15-e16 - Granite State + Felina.mkv
│   └── Season 00/
│       └── Breaking Bad - s00e01 - No Half Measures.mkv
├── Chernobyl (2019)/
│   └── Season 01/
│       └── Chernobyl - s01e01 - 1:23:45.mkv
└── The Daily Show (1996)/
    └── Season 29/
        └── The Daily Show - 2024-03-15.mkv

Compare to Jellyfinでの同等の設定.

Kodi用のアニメの命名規則 (Hama Scraperを使用)

Kodiには標準のアニメ用scraperがありません。デフォルトのTheMovieDBやTheTVDBアドオンはアニメを通常のテレビ番組として扱いますが、これは最近のシーズン制の少年漫画には有効なものの、「One Piece」や「Detective Conan」、「Bleach」のような絶対話数で管理されるシリーズではうまく機能しません。解決策はHamaです。これはPlexのアニメライブラリで使われているのと同じコミュニティ製scraperで、一度インストールすれば、お使いのKodiのすべてのアニメソースでAniDB連携が利用可能になります。

Hamaのセットアップ（約10分、初回のみ）

KodiでのHamaのセットアップは約10分で完了します： 1. github.com/ZeroQI/Hama.bundle からHamaをダウンロードします（Plex用のbundleがKodi Hamaアドオンラッパー経由でKodiでも動作します）。別な方法として、お使いのKodiのバージョンで利用可能であれば、公式Kodiアドオンリポジトリから「Hama」をインストールすることもできます。 2. Kodiで：設定 → アドオン → リポジトリからインストール → 情報プロバイダー → TV shows → Hamaをインストールします（Hama.bundleが別に表示されている場合はそれもインストールします）。 3. アニメ専用のソースを作成します。アニメフォルダを指すビデオソースを追加し、コンテンツの種類を「TV shows」に設定し、scraperとしてTheMovieDBやTheTVDBの代わりに「Hama」を選択します。 4. HamaはデフォルトでAniDBをプライマリデータベースとして使用します。scraperの設定で優先順位を変更できます。絶対話数の番組にはAniDBを優先、英語吹替のメタデータが欲しい番組にはTVDBを優先することをおすすめします。 5. ソースでscrapeを実行します。最初のscrapeは（Hamaが複数のデータベースに問い合わせるため）時間がかかりますので、しばらくお待ちください。2回目以降のscrapeははるかに高速です。

絶対話数での番号付け

「One Piece」（エピソード1,064）のような絶対話数で管理されるシリーズでは、シーズン01を使用し、エピソード番号を4桁にゼロパディングします：

Anime/
└── One Piece [anidbid-69]/
    └── Season 01/
        ├── One Piece - s01e0001.mkv
        ├── One Piece - s01e0002.mkv
        └── One Piece - s01e1064.mkv

フォルダ名の末尾にある `[anidbid-X]` は、Hamaにあいまいなタイトル一致をスキップさせ、直接AniDBのエントリを使用するよう強制します。IDはanidb.netで番組を検索すると、URL内に見つかります。 4桁のゼロパディングはマッチングに必須ではありませんが、ファイルシステムのソート順を再生順と一致させるために役立ちます。パディングがないと、ファイル `e1064` は `e1063` の後ではなく `e11` の後にソートされてしまい、Kodi以外の場所でフォルダを閲覧する際に混乱を招きます。

分割シーズンと章（アーク）

最近のアニメは「パート」（「Attack on Titan Final Season Part 1/2/3」や「Demon Slayer」の各章など）に分割されることがあり、PlexやJellyfinと同様のscrapingの混乱を引き起こします。解決策は、どのデータベースがご自身の考える番組構成と一致するかを決め、フォルダIDの接尾辞でそれを強制し、すべてのアニメで一貫性を保つことです。

Anime/
├── Attack on Titan [anidbid-9541]/
│   ├── Season 01/
│   ├── Season 02/
│   ├── Season 03/
│   └── Season 04/   ← Final Season Part 1
├── Attack on Titan - Final Season Part 2 [anidbid-15689]/
│   └── Season 01/   ← AniDB tracks Part 2 as its own entry
└── Demon Slayer (2019)/
    ├── Season 01/
    ├── Season 02/   ← Mugen Train + Entertainment District
    └── Season 03/

命名例（まとめ）

Anime/
├── One Piece [anidbid-69]/
│   ├── Season 01/
│   │   ├── One Piece - s01e0001.mkv
│   │   └── One Piece - s01e1064.mkv
│   └── Season 00/
│       └── One Piece - s00e001 - Movie 14 Stampede.mkv
├── Attack on Titan [anidbid-9541]/
│   ├── Season 01/
│   └── Season 04/
└── Demon Slayer (2019)/
    └── Season 02/
        └── Demon Slayer - s02e01.mkv

Same scraper in Plex? Plexのアニメ（HAMAは同じscraperです）.

Kodi用の音楽ファイルの命名

Kodiの音楽ライブラリは、PlexやJellyfinと全く同じように、まずタグ、次にフォルダ構造で管理されます。Universal Album Scraper（Kodi 19以降のデフォルト）はID3タグを読み取り、MusicBrainzとTheAudioDBに問い合わせてアートワークやメタデータを取得します。まずはタグを修正し、フォルダ構造は後から考えましょう。

推奨されるフォルダレイアウト

推奨レイアウト：

Music/
├── Pink Floyd/
│   ├── The Dark Side of the Moon (1973)/
│   │   ├── 01 - Speak to Me.flac
│   │   └── 02 - Breathe.flac
│   └── Wish You Were Here (1975)/
│       └── 01 - Shine On You Crazy Diamond Pts. 1-5.flac
├── Various Artists/
│   └── Pulp Fiction Soundtrack (1994)/
│       ├── 01 - Misirlou - Dick Dale.flac
│       └── 02 - Royale with Cheese - John Travolta.flac
└── Tool/
    └── Lateralus (2001)/
        ├── Disc 01/
        │   └── 01 - The Grudge.flac
        └── Disc 02/
            └── 01 - Faaip de Oiad.flac

フォルダ名にはアルバムの年を入れることをお勧めします。複数枚組のアルバムは「Disc XX」というサブフォルダを使用します。コンピレーションアルバムでは、「Various Artists」というアルバムアーティストタグを使用します（Album Artistタグは「Various Artists」に設定し、個々のArtistタグはトラックの演奏者のままにします）。

Kodiが実際に使用するID3タグ

Kodiで正しくマッチングさせるために必須のID3タグは、Artist、Album、Title、Track Numberです。Album Artist（コンピレーションではArtistと区別）、Year、Genre、Disc Number、MusicBrainz IDも強く推奨されます。 MusicBrainz ID（Album IDとRecording ID。ID3v2.3のTXXXフレームまたはVorbisコメントとして埋め込まれます）を使用すると、KodiのUniversal Album Scraperが曖昧なタイトルマッチングを回避し、正確にマッチングできるようになります。MusicBrainz Picardを使ってこれらのIDを一度書き込んでおけば、Kodiのライブラリはほぼ完璧になります。 RenameFlowの音楽モードはMusicBrainzを読み取り、正確なファイル名とフォルダ構造を生成しますが、ID3タグは書き込みません。Picardのようなタガーの代わりとしてではなく、タガーで処理した後に使用してください。

完全な例

Music/
└── Pink Floyd/
    ├── The Dark Side of the Moon (1973)/
    │   ├── 01 - Speak to Me.flac
    │   └── 10 - Eclipse.flac
    └── The Wall (1979)/
        ├── Disc 01/
        │   └── 01 - In the Flesh?.flac
        └── Disc 02/
            └── 01 - Hey You.flac

NFOファイル — Kodiのメタデータ上書きシステム

NFOファイルは、命名規則においてKodiとPlex/Jellyfinの最大の違いです。NFOは動画ファイルの隣に置く小さなXMLファイルで、Kodiはオンラインのscraperに問い合わせる代わりにこのファイルを読み込みます。NFOは任意ですが非常に便利です。間違ったscraperのマッチングを上書きしたり、カスタムコレクションを記録したり、オンラインデータベースの変更によって変動する可能性のあるメタデータを固定したりできます。 Plexには同等の機能はありません。Jellyfinはローカル画像と最小限のXMLで部分的にサポートしています。KodiのNFOシステムは、オープンソースのメディアセンターの中で最も成熟した実装です。

NFOファイルを作成すべき時（とそうでない時）

すべてのファイルにNFOが必要なわけではありません。scraperが90%のマッチングを正しく処理してくれます。NFOファイルを作成する価値があるのは、以下の4つのシナリオです。 1. scraperが間違った映画や番組を選択し、KodiのUIで「編集」しても修正が反映されない場合（リメイクの多い番組でよくあります）。 2. 映画や番組がTMDB/TVDBに全く存在しない場合（地域限定リリース、ファン編集版、ニッチなコンテンツなど）。 3. TMDBが提供するもの以外のカスタムコレクションを作成したい場合（例：自分だけの「90年代SFベスト」セット）。 4. 失いたくないメタデータを保存する場合 — データベースが破損しても、NFOファイルだけでKodiのライブラリを再構築できます。 200アイテム未満のライブラリでは、NFOファイルは通常やりすぎです。1,000アイテムを超え、メタデータの修正に時間を費やしたライブラリでは、NFOは保険のようなものです。

movie.nfo — 最も便利なNFO

映画のNFOフォーマットです。ファイルを映画の隣に `movie.nfo` という名前で配置します (または、動画ファイル名に合わせた `Title (Year).nfo` でも構いません。どちらでも機能しますが、`movie.nfo` が一般的です):

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<movie>
  <title>Blade Runner</title>
  <originaltitle>Blade Runner</originaltitle>
  <year>1982</year>
  <plot>A blade runner must pursue and terminate four replicants...</plot>
  <runtime>117</runtime>
  <mpaa>R</mpaa>
  <genre>Science Fiction</genre>
  <genre>Thriller</genre>
  <director>Ridley Scott</director>
  <actor>
    <name>Harrison Ford</name>
    <role>Rick Deckard</role>
  </actor>
  <uniqueid type="tmdb" default="true">78</uniqueid>
  <uniqueid type="imdb">tt0083658</uniqueid>
  <set>
    <name>Blade Runner Collection</name>
  </set>
</movie>

`<uniqueid type="tmdb">` フィールドは、Kodiがタイトルを曖昧にマッチングする代わりに、特定のTMDBエントリーを使用するように強制します。これは最も便利なタグです。もしNFOファイルに一つだけ何かを書き込むとしたら、これを書きましょう。

tvshow.nfo — 番組レベルのオーバーライド

TV番組のNFOファイルは、番組のルートフォルダに `tvshow.nfo` という名前で配置します。フォーマットは `movie.nfo` と似ていますが、番組レベルのフィールドが含まれます:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<tvshow>
  <title>Breaking Bad</title>
  <year>2008</year>
  <plot>A high school chemistry teacher diagnosed with cancer...</plot>
  <genre>Crime</genre>
  <genre>Drama</genre>
  <uniqueid type="tvdb" default="true">81189</uniqueid>
  <uniqueid type="tmdb">1396</uniqueid>
  <uniqueid type="imdb">tt0903747</uniqueid>
  <status>Ended</status>
  <studio>AMC</studio>
</tvshow>

ほとんどのユーザーにとってTheTVDBがKodiのデフォルトのTV scraperであるため、`<uniqueid type="tvdb">` はTV番組にとって最も信頼性の高いロックとなります。

エピソードごとのNFO (めったに必要ありません)

エピソードごとのNFOファイルはめったに必要ありません。ほとんどのケースは、番組レベルのNFOとscraperが取得したエピソードのメタデータでカバーされます。特定のエピソードが一致せず、番組を更新しても修正されない場合にのみ使用してください。フォーマットは、`Show - s01e01.nfo` を動画ファイルの隣に配置します:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<episodedetails>
  <title>Pilot</title>
  <season>1</season>
  <episode>1</episode>
  <aired>2008-01-20</aired>
  <plot>Walter White, a struggling high school chemistry teacher...</plot>
  <uniqueid type="tvdb" default="true">349232</uniqueid>
</episodedetails>

高度なメタデータタグ

基本的な<title>、<year>、<plot>タグ以外にも、Kodiはライブラリでのアイテムの表示方法をカスタマイズできる豊富なメタデータフィールドを理解します。パワーユーザーにとって最も便利なものを紹介します。 <originaltitle> — 原語のタイトルです。情報ページでローカライズされたタイトルと並べて表示されます。（『Spirited Away』と『千と千尋の神隠し』のように）国内配給会社のタイトルが原題と大きく異なる外国映画にとって非常に重要です。 <sorttitle> — デフォルトのソート順を上書きします。これを使えば、「The Matrix」を「T」ではなく「M」でソートさせたり、正式なタイトルに関係なく続編をグループ化したりできます。例：すべての「Mission: Impossible」シリーズを「Mission Impossible 01」、「Mission Impossible 02」のようにソートする。 <tagline> — タイトルの下に表示される短いマーケティング用のキャッチコピーです（例：「宇宙では、あなたの悲鳴は誰にも聞こえない」）。ライブラリの情報ページを洗練させます。 <status>（TV番組用） — 「Continuing」、「Ended」、「Returning Series」のいずれかを指定します。これにより、Kodiのスキンが番組カードに適切なインジケーターを表示できるようになります。 <premiered> — 公式の初回放送日です。scraperが取得した日付が間違っているアンソロジー番組やアニメに便利です。 <fileinfo>ブロック — 事前にキャッシュされたファイルメタデータ（codec、解像度、音声言語トラック）です。NFOファイルをプログラムで生成し、Kodiの初回スキャン時のメディア分析をスキップしたい場合に便利です。

複数の評価ソースを並べて表示

Kodi 19以降では、複数の評価ソースを同時に表示できます。好きなだけソースを追加して<ratings>ブロックを作成してください。

<ratings>
  <rating name="imdb" max="10" default="true">
    <value>8.1</value>
    <votes>826543</votes>
  </rating>
  <rating name="themoviedb" max="10">
    <value>8.2</value>
    <votes>9876</votes>
  </rating>
  <rating name="rottentomatoes" max="100">
    <value>89</value>
    <votes>410</votes>
  </rating>
</ratings>

Kodiのデフォルトスキンでは、「default」に指定された評価が目立つように表示され、情報ダイアログで他の評価を切り替えることができます。信頼するソースを厳選しているライブラリにとって、これはscraperから取得される単一ソースの評価と比べて、使い勝手を大きく向上させる有意義なアップグレードです。

音楽用NFOファイル（アーティスト、アルバム、トラック）

音楽には、アーティスト、アルバム、トラックごとの3つのレベルを持つ独自のNFOフォーマットがあります。アーティストレベルのNFOは、アーティストフォルダのルートに `artist.nfo` という名前で配置します。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<artist>
  <name>Pink Floyd</name>
  <disambiguation>British rock band</disambiguation>
  <formed>1965</formed>
  <disbanded>2014</disbanded>
  <genre>Progressive Rock</genre>
  <musicBrainzArtistID>83d91898-7763-47d7-b03b-b92132375c47</musicBrainzArtistID>
</artist>

MusicBrainz Artist IDを使用すると、Kodiの音楽ライブラリはあいまいな一致に頼らずに正規のエントリにリンクできます。これは、一般的な名前を持つアーティストや複数の名義で活動するアーティストにとって非常に便利です。 アルバムレベルのNFO（アルバムフォルダ内の `album.nfo`）は、同様のフィールドに加えて<title>、<year>、<musicBrainzAlbumID>を受け入れます。トラックごとのNFOはめったに使用されません。Kodiのタグ駆動の音楽モデルは、NFOファイルではなくID3タグを介してトラックを処理します。

NFOでよくある落とし穴

NFOファイルが正常に機能しなくなる、よくある4つの間違い： 1. 無効なXML — <plot>や<title>タグ内で&、<、>の文字がエスケープされていない状態です。解決策：テキストコンテンツを<![CDATA[...]]>で囲むか、手動でエスケープ(&amp;, &lt;, &gt;)します。 2. 不正なエンコーディング — NFOファイルは必ずUTF-8でなければなりません。一部のWindowsテキストエディタはデフォルトでWindows-1252として保存するため、非ASCII文字（アクセント記号、キリル文字、日本語など）が文字化けします。UTF-8に対応したエディタ（VS Code、Sublime Text、Notepad++など）を使用してください。 3. XML宣言の欠落 — 最初の行にある<?xml version="1.0" encoding="UTF-8" standalone="yes"?>は必須です。これがないと、一部のKodiバージョンではファイルが警告なしにスキップされます。 4. NFOとスクレイピングされたメタデータの競合 — NFOとscraperの両方が同じフィールドのデータを提供する場合、KodiはNFOを優先します。これは通常望ましい動作ですが、NFOがオンラインの更新を上書きしていることに気づかないユーザーを驚かせることがあります。スクレイピングされたデータに戻すには、NFOファイルを削除して更新してください。

NFOファイルの配置例

Movies/
└── Blade Runner (1982)/
    ├── Blade Runner (1982).mkv
    ├── movie.nfo               ← TMDB IDをロック
    └── poster.jpg

TV Shows/
└── Breaking Bad (2008)/
    ├── tvshow.nfo              ← TVDB IDをロック
    ├── Season 01/
    │   ├── Breaking Bad - s01e01 - Pilot.mkv
    │   └── Breaking Bad - s01e01.nfo   ← エピソードごとのオーバーライド (稀)
    └── Season 02/

Don't want to hand-write NFOs? またはFilebotのNFOライターを使用します.

Kodiの命名に関するトラブルシューティング

Kodiの命名に関する問題の約85%は、6つの失敗パターンに集約されます。それぞれに予測可能な原因と明確な解決策があります。

60秒で完了する代替案

ここまでの説明はすべて手作業による方法です。scraperの仕組みを理解し、正しいファイル名を入力し、厄介なケースではNFOファイルを作成します。新しいライブラリを構築する際には一度はやってみる価値がありますが、長年にわたる整理されていないダウンロードで溜まった2,000ファイルのライブラリに対しては、骨の折れる作業です。

手作業の場合

手作業でKodiライブラリのファイル名を変更する場合、1項目あたり約30〜60秒かかります。タイトルの確認、公開年のフォーマット、sXXeYYパターンの修正、そして問題のある数少ないケースでのNFOファイル作成などです。2,000ファイルのライブラリとなると、週末が丸ごと潰れてしまうほどの作業量です。

60秒で完了する方法

RenameFlowなら、リネームは数秒で完了します。フォルダーをドロップすると、パーサーが映画・ドラマ・アニメのいずれかを判別し、TMDB / TheTVDB / AniList / MusicBrainzに並行して問い合わせて、Kodi準拠のリネームのプレビューを表示します。承認すると、File System Access APIによりディスク上でローカルにリネームされます。アップロードはありません。毎日最初の15ファイルまで無料、69ユーロの一回払いで無制限に利用できます。 NFOファイルの生成については、RenameFlowはNFOを直接書き出しませんが、Kodiのデフォルトのスクレイパーで問題なく認識されるファイル名を生成するため、90%のケースではNFOが不要になります。残りの10%については、NFOを手で書くのは一度きりの手間です。

See RenameFlowの料金.

Kodiのファイル命名 — よくある質問

→ RenameFlowのよくある質問をすべて見る

こちらもご覧ください

• → Plex 命名ガイド（Kodi との対応）
• → Jellyfin 命名ガイド
• → ステップバイステップのリネーム手順解説
• → RenameFlow のよくある質問（すべて）

公式リファレンス： Kodi ビデオファイルの名前の付け方（公式 Wiki） · Kodi の NFO ファイル（公式 Wiki） · Hama scraper（GitHub）