Kometa マネージャー

アートワークをメタデータとして出力するだけでなく、/kometa で Kometa の config.yml を管理できます。パスが未設定ならファイルを読み書きしない任意機能です。

設定とメタデータは役割が異なります

• posterpilot-movies.yml は TMDB 名前空間の映画アートワークです。TMDB ID がない場合は IMDb を使用します。
• posterpilot-shows.yml は TVDB 名前空間の番組、シーズン、エピソードです。TVDB ID がない場合は IMDb を使用します。名前空間は PosterPilot に記録された種類で決まり、数値キーから推測しません。
• config.yml は Kometa の接続、ライブラリ、コレクション、オーバーレイ、操作、設定です。

有効化とマウント

変数	既定	内容
KOMETA_CONFIG_PATH	空	マウントした config.yml の絶対パス。空なら無効。
KOMETA_CONFIG_MODE	merge	merge は未管理内容を保持、own は全体を再生成。
KOMETA_SERVER_INSTANCE_ID	従来サーバー	Kometa に結び付ける名前付き Plex。
KOMETA_METADATA_PATH_PREFIX	config	Kometa の実行環境から見える相対ディレクトリ。.（または UI 欄を空）ならファイル名だけを使います。

設定ディレクトリをコンテナへ読み書き可能でマウントします。インストールを参照してください。Kometa は Plex 専用で、Jellyfin／Emby や別インスタンスの資格情報を暗黙に使うことは拒否します。

物理的な出力パスと Kometa の参照は別物です。PosterPilot は設定された出力ディレクトリに 2 ファイルを並べて書きますが、file: は Kometa の実行環境から見た同じファイルを指す必要があります。既定では config/posterpilot-movies.yml と config/posterpilot-shows.yml です。別名のマウントによってファイルが物理的に config.yml の隣にあっても同様です。この値は相対プレフィックスであり、ホストパス、コンテナの絶対パス、URL、YAML ファイル名ではありません。

管理する領域

• Plex、TMDB、Tautulli、Trakt、MDBList、OMDb、GitHub、Radarr、Sonarr、Notifiarr、Gotify、ntfy、AniDB、MAL の接続（シークレットはマスク）。
• metadata_files、collection_files、オーバーレイ、操作、個別設定を含むライブラリ。
• 選択したグローバル設定と webhook。
• ファイル全体の Raw config.yml。
• 書き込み時のタイムスタンプ付きバックアップ。

merge は管理キーだけを変更し、他のキーとコメントを残します。YAML anchor／alias を含むセクションは安全に部分更新できないため警告して省略します。必要なコネクターがない chart／overlay も整合性警告に出ます。

構造化プレビューと確認

1. パス、モード、Plex バインドを保存します。
2. PosterPilot が管理する領域を編集します。
3. 変更をプレビューします。
4. 追加、変更、削除、警告、秘匿化 diff を確認します。
5. プレビュー済み同期を確認します。

プランは期限付き、1 回限りで、ファイル指紋、Plex インスタンス、モード、提案内容全体に結び付いています。入力を変えると無効になります。古い、変更済み、期限切れ、再利用済みのプランは何も書きません。

従来の posterpilot.yml を移行する

リリースを待ってください

posterpilot.yml を手動で改名、分割、再配線しないでください。この移行を含む PosterPilot のリリースが Releases に公開されてからインスタンスを更新し、/kometa に表示される移行を使ってください。

従来の単一ファイルでは映画と番組が同じ TMDB 名前空間にあるように混在する場合があります。移行は次のように正規化します。

1. プレビュー。 従来ファイルを、バインドされた Plex ライブラリと正確な改訂履歴に照合します。表示するのは構造、指紋、件数だけで、アートワーク URL や資格情報は表示しません。映画は TMDB（なければ IMDb）、番組は TVDB（なければ IMDb）です。
2. 曖昧さ。 数値キーは種類間で衝突し得るため推測しません。証拠のないエントリは分離されます。対応を修正するか、曖昧さを明示的に受け入れて移行後に PosterPilot で再適用してください。再適用すると正しい型別ファイルへ書かれます。既存の型別エントリと競合する内容も上書きしません。
3. 確認。 永続ジャーナルと保護バックアップを先に記録し、両方の型別ファイルを書いて検証してから、最後に config.yml を変更します。従来の posterpilot.yml は変更も削除もしません。
4. 再試行／再開。 中断後は検証済みチェックポイントから再開し、再分類しません。ファイルがプレビュー時または書き込み済みの指紋と一致しなければ、上書きせず再確認を求めます。

metadata_files の所有を安全に証明できる場合は config.yml を自動配線します。できない場合は型別ファイルを書き、ライブラリごとの正確な参照ガイドを表示します。その部分的な libraries: ブロックを設定全体に上書きしないでください。 指定された各ライブラリで、file の basename が posterpilot.yml の metadata_files 項目があればその項目だけを置き換え、なければ表示された型別項目を 1 回だけ追加します。他の項目とライブラリ設定をすべて保持し、型別参照が正確に 1 つ、アクティブな従来参照が 0 になったことを確認してください。Kometa の実行環境からパスを確認してから PosterPilot で完了を承認します。この承認はユーザーの申告を記録するもので、PosterPilot が手動編集を検証したという意味ではありません。

Rollback は現在の設定が移行結果と完全一致する場合だけ、保護された移行前 config.yml を復元します。型別ファイルと従来ファイルは残るため、生成済みアートワークを失わず、再試行時に再構築する必要もありません。

Raw エディター

Raw 変更をプレビューは最初に YAML を検証します。構文エラーは画面内に表示し、プランを発行しません。Raw 保存を確認は別操作で、プレビューに結び付いたテキストだけを書きます。テキストまたはディスク上のファイル変更後は再プレビューが必要です。

バックアップと復元

確定書き込みは原子的に置換し、以前の版を config.yml.posterpilot-bak-<timestamp> として保存します。復元も最初に diff をプレビューし、別に確認します。現在ファイルまたはバックアップが変わると拒否し、置換前に現在ファイルもバックアップします。

平文のシークレット

Kometa は config.yml 内の Plex トークンと TMDB キーを平文で必要とし、ディスク上のバックアップにも含まれます。PosterPilot は UI／diff では伏せますが、Kometa が読むファイルを暗号化できません。ボリュームと権限を保護してください。

安全性と元に戻す と 自動化と復旧も参照してください。