missuo/kumone
Swift0 / 0
SwiftUI로 만든 macOS용 NetEase Cloud Music 비공식 클라이언트
TL;DR
Kumone은 SwiftUI와 Swift 6.2로 만든 macOS 15+용 NetEase Cloud Music 비공식 클라이언트입니다. QR code 로그인, 개인화 추천, 플레이리스트 관리, AVPlayer 재생, 동기화 가사, 데스크톱 가사 창을 하나의 Native 앱에 묶고 NetEase API에 직접 연결합니다. weapi·eapi 암호화와 쿠키 저장을 Swift로 처리하며, 회색 트랙은 pyncmd·Kuwo·Kugou 기반 대체 음원 소스로 해소합니다. macOS용 음악 앱을 직접 빌드하거나 기능을 확장하려는 개발자에게 적합하지만 NetEase 계정·API 의존성과 제3자 음원 사용 조건은 도입 전에 확인해야 합니다.
핵심 포인트
- macOS 15+에서 동작하는 SwiftUI 기반 NetEase Cloud Music 비공식 Native 클라이언트입니다. QR code 로그인 뒤 쿠키를 로컬에 저장하고 자동 갱신하며, Apple Silicon과 Intel을 모두 지원합니다. Homebrew Cask나 서명·공증된 Release 앱으로 설치할 수 있어 macOS 사용자에게 바로 시험하기 좋습니다.
- 재생 기능은 AVPlayer와 통합되어 Standard부터 Hi-Res까지 음질을 선택하고, 셔플·반복·재생 대기열·최근 재생 상태를 처리합니다. 회색 트랙은 pyncmd·Kuwo·Kugou 소스를 사용하는 UnblockService가 대체 음원 URL을 찾도록 구성되어 있습니다. 다만 제3자 음원을 활용하므로 NetEase Cloud Music의 정책과 음원 권리 조건을 확인한 뒤 사용해야 합니다.
- API 호출에 별도 서버를 두지 않고 Swift 코드가 music.163.com과 interface.music.163.com에 직접 요청합니다. weapi는 이중 AES-CBC와 RSA를, eapi는 AES-ECB와 MD5 digest를 Native 구현하며 NeteaseClient가 전송과 쿠키를 관리합니다. Swift 코드를 직접 빌드하거나 수정하려는 개발자에게 네트워크 계층과 Player 계층의 경계가 비교적 분명합니다.
- Home에는 일일 추천·Personal FM·Heartbeat Mode·추천 플레이리스트·차트가 있고 Explore에는 카테고리별 플레이리스트와 infinite scrolling이 있습니다. Library에서는 좋아요한 곡, 생성·구독 플레이리스트, 저장 앨범, 팔로우 아티스트, 최근 재생, Cloud Disk를 관리합니다. 데스크톱 가사 창과 Now Playing 연동까지 포함해 단순 음악 재생기보다 계정 기반 서비스 클라이언트에 가깝습니다.
이미지 분석




708
STARS
47
FORKS
+205
TRENDING
0
조회수
관련 토론
아직 관련 토론이 없습니다.
댓글
댓글을 작성하려면 로그인이 필요합니다.