Arquivos Sidecars XMP

O Immich pode ingerir arquivos sidecars XMP ao fazer upload de arquivos (via CLI), bem como detectar novos sidecars que são colocados no sistema de arquivos para imagens existentes.

Os arquivos sidecars XMP são arquivos XML externos que contêm metadados relacionados a arquivos de mídia. Muitos aplicativos leem e escrevem esses arquivos, exclusivamente ou em adição aos metadados escritos nos arquivos de imagem. Eles podem ser uma ferramenta poderosa para editar e armazenar metadados de um arquivo de mídia sem modificar o próprio arquivo de mídia. Quando o Immich recebe ou detecta um arquivo sidecar XMP para um arquivo de mídia, ele tentará extrair os metadados tanto do sidecar quanto do arquivo de mídia. Ele dará prioridade aos metadados dos campos no sidecar, mas recorrerá e usará os metadados no arquivo de mídia, se necessário.

Ao importar arquivos via o uploader em massa do CLI ou ao analisar os metadados das fotos para bibliotecas externas, o Immich detectará automaticamente arquivos sidecar XMP como arquivos que existem ao lado do arquivo de mídia original. O Immich procurará arquivos que tenham o mesmo nome que a foto, mas com a extensão de arquivo .xmp. O mesmo nome pode incluir a extensão do arquivo da foto ou não incluir a extensão do arquivo da foto. Por exemplo, para uma foto chamada PXL_20230401_203352928.MP.jpg, o Immich procurará um arquivo XMP chamado PXL_20230401_203352928.MP.jpg.xmp ou PXL_20230401_203352928.MP.xmp. Se ambos PXL_20230401_203352928.MP.jpg.xmp e PXL_20230401_203352928.MP.xmp estiverem presentes, o Immich dará preferência a PXL_20230401_203352928.MP.jpg.xmp.

Existem dois trabalhos de administrador associados aos arquivos sidecars: SYNC e DISCOVER. O trabalho de sincronização irá reescanear todos os arquivos de mídia com arquivos sidecars existentes e colocá-los na fila para uma atualização de metadados. Este é um excelente caso de uso quando aplicativos de terceiros são usados para modificar os metadados de mídia. O trabalho de descoberta tentará verificar no sistema de arquivos novos arquivos sidecars para todas as mídias que atualmente não possuem um arquivo sidecar associado.