darknessomi/musicbox

Python으로 작성된 고품질 NetEase Cloud Music 명령줄 클라이언트입니다.

MusicBox 개발에 힘써주신 모든 분들께 감사드립니다.

Netease Cloud Music의 API 기능은 NeteaseCloudMusicApiEnhanced/api-enhanced에서 지원됩니다.

데모

기능적 특징

• 다중 레벨 오디오 재생을 지원합니다: MP3(초고/고/표준) 및 무손실, HD Authentic, Ultra HD 마스터링 및 기타 FLAC 재생, mpv 설치 후 자동으로 전환됨.
• 노래, 아티스트, 앨범, 지역 리스트에 대한 퍼지 검색 지원
• 차트, 신규 앨범 목록, 큐레이션 플레이리스트, 앵커 라디오, 마이 플레이리스트, 마이 클라우드 드라이브, 프라이빗 FM, 일일 추천 지원
• 지역 인기 곡, 곡 리뷰, 앨범 점프, 캐주얼 DJ 활동, 예정된 퇴장 지원
• 재생 진행 상황, 재생 모드, 현재/과거 재생목록, 데스크톱 가사 표시 지원
• Vim 스타일 단축키, 숫자 단축키, 맞춤형 글로벌 단축키 지원

설치

전 세계 명령어 musicbox는 uv 또는 pipx를 사용하여 설치하는 것이 권장됩니다; 개발 참여에 대해서는 아래의 "로컬 개발"을 참조하세요.

환경 요구 사항

• Python 3.10 이상
• mpg123 (MP3), mpv (선택 사항, FLAC / 하이-레지션)

시스템 의존성 설치

macOS:

Ubuntu/Debian:

CentOS/Red Hat:

뮤직박스 설치

PyPI (소스 코드에 뒤처질 수 있음):

소스 코드 (전역 명령어; 코드를 수정한 후 재설치, 개발 중 사용 가능 -e):

지역 개발 (글로벌 지휘부 없음):

선택적 의존성

• aria2: 캐시된 노래
• libnotify-bin: 리눅스 메시지 프롬프트
• qtpy python-dbus dbus qt: 데스크톱 가사. 시스템 Qt 버전에 따라 pyqt4, pyside 또는 pyside2 설치가 필요할 수 있습니다.

라즈베리 파이 / 구식 장비

Ubuntu 22.04 / 64비트 라즈베리 파이 시스템은 Python 3.10을 탑재하고 있으며, pipx를 통해 직접 설치할 수 있습니다. 저성능 기기의 경우, 한 번에 큰 그래픽/비디오 의존성을 끌어당기는 것을 피하기 위해 MP3 재생 의존성만 설치하는 것이 권장됩니다:

참고: 이 프로젝트는 Python 3.10 이상이 필요합니다; 구형 Raspberry Pi OS / Debian이 여전히 Python 3.9를 실행 중이라면, 현재 버전을 직접 설치할 수 없습니다.

시스템 검증 완료

• Ubuntu 24.04 LTS x64
• macOS 26.5
• 라즈베리 파이 4 / Ubuntu 22.04 arm64 (도커 이미지: balenalib/raspberrypi4-64-ubuntu:jammy)

사용

뮤직박스 시작:

로그인이 필요한 기능에 접근할 때, 터미널은 QR 코드를 표시합니다. 로그인은 코드 스캔만 지원하며, 더 이상 계정 및 비밀번호 로그인은 지원하지 않습니다.