목차

Stream App 도움말

Stream은 NAS 사용자를 위해 설계된 개인 사진 관리 도구입니다. 관리 인터페이스일 뿐이며 사진 데이터를 저장하지 않으므로 Stream을 사용해도 원본 데이터에 영향을 주지 않습니다. 언제든지 Stream 사용을 중단할 수 있으며 데이터를 잃지 않습니다.

현재 Stream은 다음 미디어 소스를 지원합니다:

미디어 소스 테스트된 버전
Immich v1.118.2
Photoprism Build 240915-e1280b2fb
로컬 사진 iOS 18
WebDAV
S3
FTP

WebDAV, S3, FTP는 파일 시스템 기반 미디어 소스입니다. 이러한 소스에서 생성된 사용자 마크 데이터(관리 작업 및 앨범 데이터 포함)는 앱 내에만 저장됩니다——데이터 손실을 방지하려면 iCloud 동기화를 활성화하거나 수동으로 백업하세요.

리소스가 제한되어 있어 제한된 범위의 버전만 테스트할 수 있습니다. 미디어 소스 지원에 문제가 발생하면 앱의 설정 페이지를 통해 피드백을 제공해 주세요.

현재 지원되는 작업으로는 Favorite, Archive, Restore, Private, Unprivate, Delete, Approve가 있습니다. 아래 표는 다양한 미디어 소스 유형에서의 대응 작업을 보여줍니다:

Stream Photoprism Immich 로컬 사진
Favorite Favorite Favorite Favorite
Archive / Restore Archive / Restore Archive / Unarchive (미지원 *)1
Private / Unprivate Private / Unprivate (미지원 *)1 Hide
Delete Delete 2 Delete 2 Delete
Approve Approve 3 (미지원) (미지원)

Stream은 다양한 미디어 소스의 사진을 합쳐서 표시합니다. 병합된 사진에 대해 Private, Archive, Delete 등의 작업을 수행하면 실제로는 원본 미디어 소스에 일괄 작업이 수행됩니다.

기본적으로 Stream은 파일 이름, 촬영 시간, 파일 해상도 등의 기본 정보를 기반으로 간단한 규칙 매칭을 사용하여 사진을 병합합니다. 해싱을 활성화하여 병합 정확도를 높일 수도 있습니다. 단, 해싱을 활성화하면 병합 작업의 시간과 배터리 소모가 증가한다는 점에 유의하세요.

사용자 마크 데이터는 즐겨찾기, 아카이브, 비공개 플래그 및 앨범 데이터 등 사진과의 상호작용을 나타냅니다.

마크 데이터의 핵심 사항:

  • 사진과 별도로 저장됨
  • 손실 시 복구 불가
  • 시스템 간 이전 시 사진과 마크 데이터 모두 필요

대부분의 사진 앱은 이 데이터를 플랫폼 내에 잠가 둡니다. Stream은 이 데이터가 사용자의 것이며 쉽게 이전하고 관리할 수 있어야 한다고 생각합니다.

미디어 소스마다 기능이 다릅니다(로컬 사진은 아카이브 불가, Immich는 비공개 미지원). Stream은 이러한 미지원 기능을 내부적으로 관리하여 공백을 채웁니다.

데이터 손실을 방지하려면 iCloud 동기화를 활성화하거나 정기적으로 백업하세요. WebDAV/S3/FTP 미디어 소스의 경우 Stream은 사진 사본을 보유하지 않으며 사용자 마크 데이터에 대한 추가 백업도 없습니다——반드시 iCloud 백업을 활성화하거나 수동으로 백업하세요.

Immich, Photoprism, 로컬 사진은 앨범 동기화를 지원하며 다음을 포함합니다:

  • 원격 → 로컬: 원격 소스에서 앨범 목록과 멤버를 자동으로 가져옴
  • 로컬 → 원격: 선택한 미디어 소스로 앨범과 멤버를 푸시
  • 이름으로 매칭: 앨범은 이름(대소문자 구분 없음)을 기준으로 미디어 소스 간 병합되며, 로컬과 원격 모두 이름을 매칭 키로 사용합니다

원격 앨범은 앱에서 새 앨범을 만들거나 단일 로컬 앨범을 원격으로 수동 동기화할 때만 자동으로 생성됩니다. 다른 작업은 원격에 동일 이름의 앨범이 없으면 건너뜁니다.

WebDAV, S3, FTP 소스는 원격 앨범 동기화를 지원하지 않지만 앱 내에서 앨범을 만들고 관리할 수 있습니다——데이터는 CloudKit을 통해 다른 기기와 동기화됩니다.

  • iCloud 동기화는 단일 앨범당 최대 5000장의 사진을 지원합니다.
  • 로컬 데이터가 iCloud 백업과 일치하지 않으면 iCloud 동기화를 껐다가 다시 켜 보세요. 전체 동기화가 한 번 실행됩니다.

시스템 제약으로 인해 tvOS는 다음을 지원하지 않습니다:

  • WebDAV / S3 / FTP 미디어 소스
  • 검색
  • 일괄 처리 도구
  1. 설정에서 ‘벡터 검색’을 활성화합니다. ‘썸네일 자동 다운로드’가 활성화되어 있어야 하며 배터리 소모가 증가할 수 있습니다.
  2. 두 가지 AI 모델인 image encodertext encoder를 다운로드합니다.
  3. 모델이 준비되면 ‘작업 실행’을 탭하여 인덱스 생성을 시작합니다.
  4. 앱을 콜드 스타트할 때마다 인덱서가 몇 초 후 자동으로 실행됩니다.

벡터 검색 기능은 이미지 콘텐츠의 유사성을 기반으로 매칭합니다. 이미지 콘텐츠와 최대한 관련된 설명을 입력하세요.

예:

  • 책 표지를 검색하는 경우 book with a blue cover를 입력할 수 있습니다
  • 특정 종류의 강아지를 찾는 경우 설명은 fluffy golden retriever로 할 수 있습니다

입력이 상세하고 정확할수록 검색 결과가 좋아집니다.

참고
이 기능으로 인해 충돌이 발생하면 ‘검색 인덱스’ 섹션에서 ‘검색 인덱스 초기화’를 시도해 보세요.
모델 인덱싱 속도(장/분) 크기(MB) 지원 언어
clip ~5300 ~280 영어
mobileClipS0 ~6500 ~100 영어
uform ~1200 ~180 아랍어, 아르메니아어, 중국어, 영어, 프랑스어, 독일어, 히브리어, 힌디어, 인도네시아어, 이탈리아어, 일본어, 한국어, 페르시아어, 폴란드어, 포르투갈어, 러시아어, 스페인어, 태국어, 터키어, 우크라이나어, 베트남어(총 21개 언어)
  • AI 모델 정확도는 다양합니다. 가장 적합한 모델을 선택하기 위해 시도하고 비교해 보세요
  • 인덱싱 속도는 iPhone 15에서 로컬 썸네일 캐시를 사용하여 테스트, 다운로드 시간 제외
  • 자세한 비교 데이터는 uform3-image-text-multilingual-base 참조

  1. 이러한 작업은 미디어 소스에서 기본적으로 지원되지 않지만 Stream이 지원을 제공합니다. 자세한 내용은 사용자 마크 데이터 섹션을 참조하세요. ↩︎ ↩︎

  2. Photoprism/Immich 설정에서 “삭제 대신 아카이브” 기능을 활성화할 수 있습니다. 읽기 전용 미디어 소스에 유용합니다. ↩︎ ↩︎

  3. Photoprism은 저품질 사진을 승인 대기 상태로 표시하며, 앨범에 정상적으로 표시되려면 수동으로 승인해야 합니다. ↩︎