Stream App 도움말
![]()
Stream이란 무엇인가요?
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은 이 데이터가 사용자의 것이며 쉽게 이전하고 관리할 수 있어야 한다고 생각합니다.
Stream은 사용자 마크 데이터를 어떻게 처리하나요?
미디어 소스마다 기능이 다릅니다(로컬 사진은 아카이브 불가, Immich는 비공개 미지원). Stream은 이러한 미지원 기능을 내부적으로 관리하여 공백을 채웁니다.
앨범
Immich, Photoprism, 로컬 사진은 앨범 동기화를 지원하며 다음을 포함합니다:
- 원격 → 로컬: 원격 소스에서 앨범 목록과 멤버를 자동으로 가져옴
- 로컬 → 원격: 선택한 미디어 소스로 앨범과 멤버를 푸시
- 이름으로 매칭: 앨범은 이름(대소문자 구분 없음)을 기준으로 미디어 소스 간 병합되며, 로컬과 원격 모두 이름을 매칭 키로 사용합니다
원격 앨범은 앱에서 새 앨범을 만들거나 단일 로컬 앨범을 원격으로 수동 동기화할 때만 자동으로 생성됩니다. 다른 작업은 원격에 동일 이름의 앨범이 없으면 건너뜁니다.
WebDAV, S3, FTP 소스는 원격 앨범 동기화를 지원하지 않지만 앱 내에서 앨범을 만들고 관리할 수 있습니다——데이터는 CloudKit을 통해 다른 기기와 동기화됩니다.
- iCloud 동기화는 단일 앨범당 최대 5000장의 사진을 지원합니다.
- 로컬 데이터가 iCloud 백업과 일치하지 않으면 iCloud 동기화를 껐다가 다시 켜 보세요. 전체 동기화가 한 번 실행됩니다.
tvOS 제한사항
시스템 제약으로 인해 tvOS는 다음을 지원하지 않습니다:
- WebDAV / S3 / FTP 미디어 소스
- 검색
- 일괄 처리 도구
벡터 검색 사용 방법은?
가이드
- 설정에서 ‘벡터 검색’을 활성화합니다. ‘썸네일 자동 다운로드’가 활성화되어 있어야 하며 배터리 소모가 증가할 수 있습니다.
- 두 가지 AI 모델인
image encoder와text encoder를 다운로드합니다. - 모델이 준비되면 ‘작업 실행’을 탭하여 인덱스 생성을 시작합니다.
- 앱을 콜드 스타트할 때마다 인덱서가 몇 초 후 자동으로 실행됩니다.
검색 팁
벡터 검색 기능은 이미지 콘텐츠의 유사성을 기반으로 매칭합니다. 이미지 콘텐츠와 최대한 관련된 설명을 입력하세요.
예:
- 책 표지를 검색하는 경우
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 참조