UniRhy

프로그램 소개

UniRhy는 자체 호스팅이 가능하고 확장 가능한 음악 스트리밍 서비스로, 사용자 중심으로 설계되었습니다. 이 프로젝트는 백엔드, 프론트엔드, 웹사이트로 구성된 모노레포 구조를 가지며, 음악 라이브러리 관리, 재생, 동기화 기능을 제공합니다. 웹, macOS, Windows, Android, iOS 등 다양한 플랫폼에서 사용할 수 있는 클라이언트를 제공합니다.

주요 기능

• 자체 호스팅 배포: 외부 서비스 의존성 없음
• 음악 리소스 관리
• 크로스 플랫폼 클라이언트: Web, macOS, Android, iOS, Windows
• 재생 상태 동기화
• 플러그인 기반 확장 지원

다운로드·설치 방법

Windows에서는 winget을 통해 설치할 수 있습니다. 다음 명령어를 사용하세요.

winget install –id Coooolfan.UniRhy –exact

macOS 설치 패키지는 서명되지 않았습니다. macOS에서 앱이 손상되었다고 보고되면 다음 명령어를 실행하여 격리 속성을 제거하세요.

xattr -cr /Applications/UniRhy.app

기본 사용법/명령어

개발 환경에서 UniRhy를 실행하려면 다음 단계를 따르세요.

1. PostgreSQL 시작: docker run -d –name unirhy-pg -e POSTGRES_DB=unirhy -e POSTGRES_USER=pgroot -e POSTGRES_PASSWORD=pgroot -p 5432:5432 postgres:17
2. server/.env 설정: cp server/.env.example server/.env
3. 모든 서비스 시작: scripts/dev.sh start
4. 상태 확인: scripts/dev.sh status

활용 예시

UniRhy를 사용하면 개인 또는 공동체를 위한 음악 스트리밍 서비스를 운영할 수 있습니다. 자체 호스팅 인스턴스를 설정하여 음악 라이브러리를 관리하고, 여러 기기에서 재생 상태를 동기화할 수 있습니다.

시스템 요구사항·호환성

UniRhy는 Windows, macOS, Android, iOS, 웹 브라우저에서 사용할 수 있습니다. 개발 환경에서는 JDK 25, Node.js 24, Yarn 4.12+, Docker, tmux가 필요합니다.

최신 버전·업데이트

현재 최신 버전은 0.1.0이며, 2026-08-11에 릴리스되었습니다. 자세한 변경 사항은 GitHub 릴리스 페이지에서 확인할 수 있습니다.

제한 사항·체크포인트

이 프로젝트는 아직 초기 단계에 있으며, 기존 기능이 크게 변경될 수 있습니다. macOS 빌드는 서명되지 않았습니다.