功能說明
시작 위치
- iPhone, iPad: 설정 → 소스 관리(라이브러리 그룹)에서 오른쪽 위의 +(소스 추가)를 탭하세요. 아직 소스가 없으면 ‘음악 소스 없음’이 표시됩니다.
- Mac: 사이드바의 소스 섹션에서 소스를 추가하고 관리합니다.
소스 유형 선택 화면에는 로컬 네트워크에서 발견된 기기가 먼저 표시되며(로컬 네트워크 검색 중...), 기기를 탭하면 주소가 미리 채워집니다. 그다음 Apple Music, 이어서 범주별로 묶인 모든 소스 유형이 표시됩니다.
지원 유형
| 범주 | 유형 |
|---|---|
| NAS | Synology(DSM 6/7, 2단계 인증 및 QuickConnect 지원), QNAP(QTS/QuTS) |
| 프로토콜 | WebDAV, SMB/CIFS(SMB2/3), FTP/FTPS/FTPES, SFTP, NFS(v3/v4), UPnP/DLNA, S3(AWS S3 / MinIO / R2) |
| 미디어 서버 | Jellyfin, Emby, Plex, Subsonic / OpenSubsonic, Navidrome, Airsonic, gonic, Feiniu Music, Daoliyu, Songloft, Audiobookshelf, Synology Audio Station, Ting Reader |
| 클라우드 드라이브 | Baidu Pan, Aliyun Drive, Google Drive, OneDrive, Dropbox, Drime, InfiniCLOUD, 115 Drive, 123 Pan, GuangYa Pan, pCloud |
| Apple | Apple Music(Apple Music 보관함 동기화), Mac에서는 Apple Music 보관함(로컬 Apple Music / iTunes)도 지원 |
| 로컬 | 이 기기의 파일(폴더 참조, 파일 참조, Primuse로 복사), 기기 전송 |
참고:
- Ugreen과 fnOS는 이 버전의 추가 목록에 없습니다(소스 코드에 ‘공개 API 대기 중 · 현재 사용 불가’로 표시됨). fnOS NAS의 음악은 Feiniu Music 또는 SMB, WebDAV 같은 일반 프로토콜로 연결할 수 있습니다.
- 115 Drive에는 ‘115 오픈 플랫폼 · 출시 예정’ 부제가 표시됩니다. 사용해 보려면 115 오픈 플랫폼에서 발급받은 개발자 앱 자격 증명이 필요합니다.
- 소스는 원하는 만큼 추가할 수 있으며 하나의 라이브러리로 합쳐집니다.
소스 추가(일반 단계)
- 유형을 선택하고 이름과 서버 주소를 입력하세요. 포트를 비워 두면 저장할 때 Primuse가 알아서 찾습니다.
- 유형에 따라 사용자 이름, 비밀번호, API 키 또는 토큰 등 자격 증명를 입력하세요. 필요하면 고급에서 포트, 경로 또는 암호화를 설정하세요.
- 저장하면 Primuse가 먼저 연결을 테스트합니다. 실패하면 원인이 표시되며(예: ‘제한 시간 안에 응답 없음’ 또는 ‘암호화 핸드셰이크에 실패했습니다’), 주소 변경 또는 그래도 저장를 선택할 수 있습니다.
- 파일 기반 소스(NAS, 프로토콜, 클라우드 드라이브)는 다음으로 스캔할 폴더를 선택하고(디렉터리 스캔: 연결한 후 음악 파일을 스캔할 디렉터리를 선택하세요) 완료을 탭하여 스캔을 시작합니다. 미디어 서버는 로그인 직후 라이브러리를 동기화합니다.
소스 유형별 필수 항목은 아래 관련 문서를 참고하세요.
소스 목록의 작업
| 작업 | 기능 |
|---|---|
| 스캔 / 스캔 재개 | 폴더의 변경 사항을 읽습니다. 중단된 스캔은 멈춘 곳에서 이어갑니다 |
| 연결 후 디렉터리 선택 / 디렉터리 관리 | 연결하고 스캔할 폴더를 선택하거나 변경합니다 |
| 점검 | 주소, 자격 증명, 경로, 네트워크를 하나씩 확인하고 해결 방법을 제안합니다 |
| 다시 로그인 | 로그인이 만료된 후 다시 로그인합니다 |
| 소스 편집 | 이름, 주소, 자격 증명, 고급 옵션을 변경합니다 |
삭제한 소스는 먼저 설정 → 최근 삭제된 항목(라이브러리 그룹)로 이동하며, 여기서 복원할 수 있습니다.
오디오북과 팟캐스트
- Jellyfin, Emby, Plex, Navidrome, Audiobookshelf, Ting Reader: 소스를 추가한 후 소스 편집를 선택하고 라이브러리에서 각 라이브러리를 음악, 오디오북 또는 동기화 안 함로 설정하세요. 서버의 각 라이브러리에 무엇이 들어 있는지 선택합니다. 오디오북 라이브러리는 책장에 들어가고 듣기 플레이어로 재생되며, 동기화하지 않는 라이브러리는 다음 스캔에서 제외됩니다.
- 기타 소스: 노래 메뉴에서 오디오북으로 표시, 팟캐스트로 표시 또는 음악으로 표시을 선택하세요. 여러 곡을 한 번에 선택할 수 있습니다.
- 이전 버전에서 이 소스는 모두 오디오북을 켠 소스는 편집할 때 이 스위치가 계속 표시됩니다. 이 소스의 모든 곡이 오디오북 책장에 들어가고 듣기 플레이어로 재생됩니다. 개별 항목은 여전히 음악으로 표시할 수 있습니다.
관련 문서
- NAS 또는 네트워크 공유 연결: Synology, QNAP, SMB, WebDAV, FTP, SFTP, NFS, S3, UPnP
- 미디어 서버 연결: Jellyfin, Emby, Plex, Subsonic/Navidrome, Audiobookshelf, fnOS Music 등
- 클라우드 드라이브 연결: Baidu Netdisk, Aliyun Drive, Google Drive, OneDrive, Dropbox, 123pan, Guangya, pCloud, Drime, InfiniCLOUD
- Primuse에서 Apple Music 사용하기
- 음악 소스가 연결되지 않거나 로그인에 실패하거나 스캔에서 노래를 찾지 못하는 경우
- 라이브러리 스캔, 새로 고침, 정리