XMP サイドカー

Immichはファイルアップロード時（CLI経由）にXMPサイドカーを取り込み、既存の画像に対してファイルシステムに配置された新しいサイドカーも検出できます。

XMPサイドカーは、メディアファイルに関連するメタデータを含む外部XMLファイルです。多くのアプリケーションは、画像ファイルに書き込まれたメタデータに加えてこれらのファイルを読み書きします。これは、メディアファイルを変更せずにそのメタデータを編集および保存するための強力なツールとなります。ImmichがメディアファイルのXMPサイドカーを受信または検出した場合、サイドカーとメディアファイルの両方からメタデータを抽出しようとします。サイドカー内のフィールドのメタデータを優先しますが、必要に応じてメディアファイル内のメタデータを使用します。

CLIバルクアップローダーを介してファイルをインポートする際や外部ライブラリの写真メタデータを解析する際、Immichは元のメディアファイルの横に存在するXMPサイドカーファイルを自動的に検出します。Immichは写真と同じ名前で、拡張子が .xmp のファイルを探します。この名前は写真のファイル拡張子を含む場合と含まない場合の両方が対象です。例えば、PXL_20230401_203352928.MP.jpg という名前の写真に対して、Immichは PXL_20230401_203352928.MP.jpg.xmp または PXL_20230401_203352928.MP.xmp という名前のXMPファイルを探します。PXL_20230401_203352928.MP.jpg.xmp と PXL_20230401_203352928.MP.xmp の両方が存在する場合、Immichは PXL_20230401_203352928.MP.jpg.xmp を優先します。

サイドカーファイルに関連する管理者ジョブが2つあります：SYNC と DISCOVER。同期ジョブは、既存のサイドカーファイルを持つすべてのメディアを再スキャンし、メタデータの更新をキューに入れます。これは、サードパーティアプリケーションを使用してメディアのメタデータを変更するケースに非常に便利です。発見ジョブは、現在サイドカーファイルが関連付けられていないすべてのメディアに対して、新しいサイドカーファイルをファイルシステムからスキャンしようとします。