tahti-player

Tahti Player는 독립 아티스트를 위한 핀란드 비영리 채널 중심 방송 플랫폼인 Tahti의 청취 및 아티스트 스튜디오 클라이언트다. Nuclear의 무료이고 광고 없는 플레이어 UI(React와 공유 디자인 시스템)를 기반으로 구축되었으며, 현재 beta.tahti.live에서 Vite SPA로 제공되고 api.tahti.live의 라이브 프로덕션 API와 통신한다. 저장소는 두 가지 주요 부분으로 구성된다. @tahti-player/tahti-web은 Nuclear 기반의 청취 및 스튜디오 웹 클라이언트로 프로덕션 apps/web의 전환 후보로 고안되었고, Tahti Player는 애드온과 공유 UI 패키지를 포함하는 Tauri 데스크톱 앱이다. 웹 클라이언트는 별도의 백엔드가 아니며 프로덕션과 동일한 공개 Tahti API, 채팅 서비스, 미디어 CDN을 사용한다. 명시된 목표는 대기열, 테마, 키보드 친화적인 크롬을 갖춘 플레이어 네이티브 셸과, 일반적인 SaaS 대시보드가 아니라 라이브 방송을 진행하기 위한 책상처럼 느껴지는 스튜디오를 제공하는 것이다. Windows, Mac, Linux용 네이티브 클라이언트를 사용할 수 있으며 관리, 메타데이터 보강, 일반 음악 관리를 위해 자체 트랙을 불러오는 기능을 지원한다. 리스너 기능에는 채널 디렉터리, 실시간 채널 HLS 및 아카이브 다시 듣기, 연중무휴 Tahti Radio 스트림, 리액션과 구독자 접근 제한이 있는 Centrifugo 웹소켓 기반 채널 채팅, 아티스트 프로필, 컬렉션과 앨범, 스마트 링크, 임베드, 공연장 디렉터리, 거버넌스 안건, 투명성 보고서, 플랫폼 상태가 포함된다. 계정 기능에는 팔로우, 즐겨찾기, 청취 기록, 플레이리스트에 추가, Stripe Checkout을 통한 팬 구독, DM, 회원 거버넌스 투표, 개인 라이브러리가 포함된다. 아티스트 스튜디오 기능에는 OBS/RTMP 및 멀티스트림을 지원하는 Go Live 마법사, 업로드·릴리스·앨범 디자이너를 갖춘 음악 라이브러리, 플레이리스트와 컬렉션, 트리밍과 마스터링을 위한 프로 오디오 편집기, 편성 및 연중무휴 프로그램, 라디오 슬롯과 쇼, 시각적 프리셋과 레이어를 갖춘 채널 디자이너, 통계, 뉴스레터 업데이트, 팬 티어와 Stripe Connect 지급을 통한 수익, Revelator를 통한 배포, 채널 중재자, 사운드 공유 링크가 포함된다. 이사회 관리자 영역에는 isBoard로 접근이 제한된 22개의 관리 화면이 있으며 대시보드, 중재 대기열, 스트림 감독, 재무, 거버넌스, 보조금, AGM, i18n, 파일 및 스토리지, 공지, 기능 요청, 지원, 라디오 제출을 다룬다. 데스크톱 Tauri 앱은 검색, 로컬 라이브러리, 애드온, 테마, 원격 제어를 갖춘 완전한 Nuclear 기반 플레이어다. 업스트림 Nuclear에서 유지된 내장 MCP 서버를 포함하며, 이를 통해 AI 에이전트가 재생, 대기열, 즐겨찾기, 플레이리스트, 제공자를 제어할 수 있다. 로컬호스트 포트 8800에 바인딩되며, CDN에서 제공되는 웹 SPA는 로컬 컨트롤 플레인 브리지를 호스팅할 수 없기 때문에 데스크톱 전용으로 문서화되어 있다. 개발자를 위해 이 프로젝트는 베타에서 라이브 API로 연결되는 동일 출처 /tahti-api 프록시, 공개 OpenAPI/Scalar 문서, 네트워크 호출 없이 fetcher가 픽스처 데이터로 단락되는 오프라인 모의 모드(VITE_FORCE_MOCK=1)를 제공한다. 스택은 pnpm과 Turborepo를 사용하며 Node 24와 pnpm 10.x가 필요하고, 데스크톱 앱에만 Tauri 2 시스템 의존성과 Rust 1.77.2 이상이 필요하다. 명령어는 웹 클라이언트와 데스크톱 앱의 개발 서버, Storybook, 빌드, 린트, 타입 검사, 테스트를 다룬다. 설정은 API 프록시 대상, API 기본 URL, 모의 모드, Centrifugo 웹소켓, hCaptcha 사이트 키, 바인드 호스트에 대한 환경 변수로 이뤄진다. 베타 사이트를 위한 배포 헬퍼가 있으며, 릴리스, Flatpak, AUR 헬퍼는 scripts 아래에 있다. README는 상태를 솔직하게 설명한다. 베타는 라이브 데이터에서 핵심 리스너 및 스튜디오 흐름을 다루지만, 이사회 관리자 기능의 깊이, 전체 SEO/SSR, 일부 설정과 같은 일부 프로덕션 화면은 Nuclear UI에서 여전히 부분적이거나 범위 밖에 있다. 기능 동등성과 남은 격차는 FEATURES.md와 FEATURES-REMAINING.md에서 추적되고, 전환 계획은 CUTOVER.md에 있다. 이 프로젝트는 Nuclear 업스트림과 동일하게 AGPL-3.0-only로 라이선스가 부여되며, AGENTS.md의 에이전트 지침과 .agents/skills 아래의 스킬을 포함한다.