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. 동기화 작업은 기존 사이드카 파일이 있는 모든 미디어를 다시 스캔하고 메타데이터 새로 고침 작업을 큐에 추가합니다. 이는 서드파티 애플리케이션으로 미디어 메타데이터를 수정할 때 좋은 사례입니다. 발견 작업은 현재 사이드카 파일이 연결되지 않은 모든 미디어에 대한 새로운 사이드카 파일을 파일 시스템에서 스캔하려고 시도합니다.