XMP-Sidecars

Immich kann XMP-Sidecars beim Hochladen von Dateien (über die CLI) sowie beim Erkennen neuer Sidecars, die für vorhandene Bilder im Dateisystem abgelegt werden, verarbeiten.

XMP-Sidecars sind externe XML-Dateien, die Metadaten zu Mediendateien enthalten. Viele Anwendungen lesen und schreiben diese Dateien entweder ausschließlich oder zusätzlich zu den in Bilddateien geschriebenen Metadaten. Sie können ein leistungsstarkes Werkzeug sein, um Metadaten einer Mediendatei zu bearbeiten und zu speichern, ohne die Mediendatei selbst zu verändern. Wenn Immich ein XMP-Sidecar für eine Mediendatei erhält oder erkennt, versucht es, die Metadaten sowohl aus dem Sidecar als auch aus der Mediendatei zu extrahieren. Es priorisiert die Metadaten für Felder im Sidecar, greift jedoch auf die Metadaten in der Mediendatei zurück, falls erforderlich.

Beim Importieren von Dateien über den CLI-Bulkuploader oder beim Parsen von Fotometadaten für externe Bibliotheken erkennt Immich automatisch XMP-Sidecar-Dateien als Dateien, die neben der ursprünglichen Mediendatei existieren. Immich sucht nach Dateien mit demselben Namen wie das Foto, jedoch mit der Dateierweiterung .xmp. Der gleiche Name kann entweder die Dateierweiterung des Fotos enthalten oder weggelassen werden. Zum Beispiel sucht Immich bei einem Foto mit dem Namen PXL_20230401_203352928.MP.jpg nach einer XMP-Datei mit entweder PXL_20230401_203352928.MP.jpg.xmp oder PXL_20230401_203352928.MP.xmp. Wenn sowohl PXL_20230401_203352928.MP.jpg.xmp als auch PXL_20230401_203352928.MP.xmp vorhanden sind, bevorzugt Immich PXL_20230401_203352928.MP.jpg.xmp.

Es gibt 2 Administratoraufgaben in Verbindung mit Sidecar-Dateien: SYNC und DISCOVER. Der Sync-Job scannt alle Medien mit vorhandenen Sidecar-Dateien erneut und stellt sie für eine Metadatenaktualisierung in die Warteschlange. Dies ist ein großartiger Anwendungsfall, wenn Drittanbieter-Anwendungen verwendet werden, um die Metadaten von Medien zu ändern. Der Discover-Job versucht, das Dateisystem nach neuen Sidecar-Dateien für alle Medien zu durchsuchen, die derzeit keine zugewiesene Sidecar-Datei haben.