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。

有兩個與副檔相關的管理員任務：SYNC 和 DISCOVER。同步任務會重新掃描所有具有現有副檔的媒體並將其排隊進行元數據刷新。當使用第三方應用程式來修改媒體的元數據時，這是一個很好的用例。發現任務則會試圖掃描檔案系統，以便為當前沒有副檔的所有媒體檔案尋找新的副檔。