guohuiyuan/go-music-dl

어떤 프로젝트인가요?

핵심 기능

• 01여러 플랫폼에서 싱글, 플레이리스트, 앨범을 한 번에 검색합니다
• 02웹, 터미널 UI, 데스크톱/모바일 앱 모드를 제공합니다
• 03Cookie 및 QR 코드 로그인을 지원해 개인 플레이리스트와 고음질 오디오를 이용할 수 있습니다
• 04메타데이터, 커버, 가사를 읽어 로컬 음악을 관리합니다
• 05FFmpeg를 사용할 수 있으면 다운로드 파일에 커버와 가사를 삽입합니다
• 06다운로드 파일을 WebDAV와 동기화합니다

활용 사례

• 한 스트리밍 서비스에서 찾을 수 없는 곡을 검색하고 다운로드하기
• 태그와 가사가 포함된 로컬 음악 라이브러리 만들기
• Docker를 사용해 홈 서버에서 음악 검색 및 다운로드 페이지 자체 호스팅하기
• 터미널에서 플랫폼 차트와 플레이리스트 둘러보기

빠른 시작

1. 1

   Releases에서 데스크톱 앱 다운로드

2. 2

   Web 인터페이스 실행

   ./music-dl web
3. 3

   또는 터미널에서 검색

   ./music-dl -k "周杰伦"
4. 4

   또는 Docker로 시작

   docker compose up -d --pull always --remove-orphans

사용 전 알아둘 점

• !AGPL-3.0 라이선스에 따라 파생 네트워크 서비스는 소스 코드를 공개해야 합니다.
• !일부 플랫폼에서는 최고 음질, 재생목록 또는 멤버 전용 트랙을 이용하려면 Cookies 또는 로그인이 필요합니다.
• !일부 플랫폼(예: Apple Music 다운로드, Qianqian 재생목록 검색)의 검색 결과는 불안정하거나 일부만 제공될 수 있습니다.
• !메타데이터 및 커버 기능을 사용하려면 Desktop, iOS, CLI 빌드에서 FFmpeg를 수동으로 설치해야 합니다.

토픽

자주 묻는 질문

go-music-dl은(는) 무엇인가요?

웹, 터미널 UI, 데스크톱 앱에서 10개 이상의 중국 및 해외 음악 플랫폼을 검색하고 다운로드하는 Go 도구입니다. Go Music DL은 NetEase Cloud Music, QQ Music, Kugou, Kuwo, Migu, Bilibili, Apple Music, JOOX 등 여러 음악 플랫폼에서 곡, 플레이리스트, 앨범, 차트를 검색합니다. 여러 소스를 한 번에 검색하고, 트랙을 미리 듣고, 일괄 다운로드할 수 있으며, 원본 소스에서 곡을 이용할 수 없을 때 다른 소스로 전환할 수도 있습니다.

go-music-dl은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

go-music-dl은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

go-music-dl은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. go-music-dl의 마지막 커밋은 2026년 10월 19일입니다.

go-music-dl은(는) 어디에 사용할 수 있나요?

한 스트리밍 서비스에서 찾을 수 없는 곡을 검색하고 다운로드하기 태그와 가사가 포함된 로컬 음악 라이브러리 만들기 Docker를 사용해 홈 서버에서 음악 검색 및 다운로드 페이지 자체 호스팅하기 터미널에서 플랫폼 차트와 플레이리스트 둘러보기

go-music-dl는 어떻게 설치하나요?

Releases에서 데스크톱 앱 다운로드 Web 인터페이스 실행: ./music-dl web 또는 터미널에서 검색: ./music-dl -k "周杰伦" 또는 Docker로 시작: docker compose up -d --pull always --remove-orphans

go-music-dl은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/guohuiyuan/go-music-dl