XMP Sidecars

Immich peut ingérer des fichiers auxiliaires XMP lors du téléchargement de fichiers (via le CLI) ainsi que détecter de nouveaux fichiers auxiliaires placés dans le système de fichiers pour des images existantes.

Les fichiers auxiliaires XMP sont des fichiers XML externes qui contiennent des métadonnées liées aux fichiers multimédias. De nombreuses applications lisent et écrivent ces fichiers soit exclusivement, soit en complément des métadonnées écrites dans les fichiers image. Ils peuvent être un outil puissant pour éditer et stocker les métadonnées d’un fichier multimédia sans modifier le fichier multimédia lui-même. Lorsque Immich reçoit ou détecte un fichier auxiliaire XMP pour un fichier multimédia, il tente d’extraire les métadonnées à la fois du fichier auxiliaire et du fichier multimédia. Il privilégiera les métadonnées des champs dans le fichier auxiliaire mais utilisera les métadonnées du fichier multimédia si nécessaire.

Lors de l'importation de fichiers via l'outil CLI de téléchargement en masse ou de l'analyse des métadonnées des photos pour des bibliothèques externes, Immich détectera automatiquement les fichiers auxiliaires XMP comme des fichiers situés à côté du fichier multimédia original. Immich recherchera des fichiers ayant le même nom que la photo, mais avec l’extension .xmp. Le même nom peut inclure ou non l'extension du fichier photo. Par exemple, pour une photo nommée PXL_20230401_203352928.MP.jpg, Immich recherchera un fichier XMP nommé soit PXL_20230401_203352928.MP.jpg.xmp, soit PXL_20230401_203352928.MP.xmp. Si les deux fichiers PXL_20230401_203352928.MP.jpg.xmp et PXL_20230401_203352928.MP.xmp sont présents, Immich préférera PXL_20230401_203352928.MP.jpg.xmp.

Il existe 2 tâches administratives associées aux fichiers auxiliaires : SYNC et DISCOVER. La tâche de synchronisation rebalayera tous les fichiers multimédias ayant des fichiers auxiliaires existants et les mettra en attente de mise à jour des métadonnées. Cela est particulièrement utile lorsque des applications tierces sont utilisées pour modifier les métadonnées des fichiers multimédias. La tâche de découverte tentera d’analyser le système de fichiers pour trouver de nouveaux fichiers auxiliaires pour tous les fichiers multimédias qui n’ont actuellement pas de fichier auxiliaire associé.