프로젝트 소개

PearTune은 자신이 소유한 컴퓨터에 음악을 보관하는 사람들을 위한 피어 투 피어 음악 플레이어입니다. 라이브러리는 그 컴퓨터 — Umbrel, NAS, 오래된 데스크톱 — 에 남아 있고, 휴대폰이 암호화된 피어 투 피어 연결을 통해 직접 접속합니다. 인터넷에 아무것도 노출되지 않으며 파일은 다른 사람의 서버로 복사되지 않습니다. README는 프로젝트를 자체 호스팅 음악에서 사람들이 실제로 어려움을 겪는 부분, 즉 원격 접속 — 리버스 프록시, 포트 포워딩, VPN, 동적 DNS 또는 유료 원격 접속 요금제 — 을 중심으로 설명합니다. 구조는 두 부분입니다. 호스트는 음악이 있는 컴퓨터에서 실행되며 라이브러리를 제공하고 접속이 허용된 기기 목록을 보관합니다. 앱은 휴대폰에서 실행되며 QR 코드를 스캔하여 호스트와 한 번 페어링합니다. 연결은 종단 간 암호화되고 상호 인증된다고 설명되므로, 호스트는 비밀번호나 연결 문자열이 아니라 연결 자체를 통해 호출하는 기기를 식별합니다. 라이브러리 소스는 compose 파일을 편집하는 대신 대시보드에서 선택합니다. 기존 Navidrome 또는 기타 Subsonic API 서버(해당 라이브러리, 아트워크, 트랜스코딩 사용), 기존 Jellyfin 서버, 또는 PearTune이 직접 태그를 읽는 일반 음악 파일 폴더(ID3, Vorbis, MP4, FLAC, 내장 커버 아트 포함)입니다. 소스를 전환해도 각 소스의 설정은 유지됩니다. Plex는 의도적으로 지원하지 않으며, README에 명시된 이유는 Plex 서버는 토큰이 매주 만료되는 plex.tv 클라우드 계정을 통해서만 읽을 수 있기 때문입니다. 접근 제어는 기기별, 사용자별로 이루어지며, 곡 재생 중을 포함해 즉시 적용되는 권한 취소가 가능합니다. 임시 게스트 패스는 정해진 시간 후 자동으로 만료되며 게스트에게 카운트다운을 보여줍니다. 앱에서 사용자는 아트워크와 함께 아티스트, 앨범, 장르 또는 트랙별로 탐색하고, 전체 라이브러리를 검색하며, 갭리스 재생, 셔플, 반복, 수면 타이머, 백그라운드/잠금 화면 오디오를 사용할 수 있습니다. 추가 기능으로는 휴대폰에서 만든 재생 목록과 읽기 전용 서버 재생 목록, 오프라인 청취를 위한 앨범 다운로드, 사용자의 기기 간에 따라오는 즐겨찾기와 이어듣기 지점(재생이 중복되지 않고 넘어감), 초대된 사람들을 위한 요청 큐, 휴대폰에서의 소유자 측 기기 관리, 여러 라이브러리를 하나의 보기로 병합하는 기능이 있습니다. 설명된 배포 현황: iOS는 App Store를 통해 1.0; Android는 Google Play에서 비공개 테스트 중이며, 그동안 릴리스 페이지의 APK와 Zapstore를 제공; 호스트 설치 프로그램은 macOS(서명 및 공증됨), Windows, Linux, Docker 이미지, Umbrel 커뮤니티 앱 스토어 등록. Windows 빌드는 아직 서명 인증서가 없어 첫 실행 시 SmartScreen 경고가 표시됩니다. Start9는 지원 대상이 아닌데, StartOS가 컨테이너 NAT 뒤에서 서비스를 실행하여 피어 투 피어 연결이 통과할 수 없어 릴레이 폴백이 강제되기 때문입니다. 직접 연결이 불가능할 때 선택적 PeerLoom 운영 릴레이가 이미 암호화된 트래픽을 전달합니다. 릴레이는 기기가 호스트와 통신 중이라는 사실과 데이터 이동량은 볼 수 있지만 내용은 볼 수 없으며 사본을 보관하지 않습니다. 기본적으로 켜져 있으며 설정 > 연결에서 비활성화할 수 있습니다. 프로젝트는 MIT 라이선스이며, Manrope 서체와 THIRD-PARTY.md에 기록된 다섯 개의 CC0 데모 트랙이 포함됩니다.