Repolode
Submit
guohuiyuan

guohuiyuan/go-music-dl

A Go tool for searching and downloading music from many Chinese and international streaming platforms, via CLI, Web, TUI, or desktop app.

View on GitHubWebsite
Stars
5,430
Forks
518
Open issues
17
Last commit
18 hours ago

What is it?

Go Music DL is a multi-platform music search and downloader. It aggregates results from more than ten services, including NetEase Cloud Music, QQ Music, Kugou, Kuwo, Migu, Bilibili, Soda Music, and Apple Music, and can search for single tracks, playlists, and albums. Lossless FLAC is supported on several platforms when valid cookies are configured.

The project ships as a command-line tool, a Web service with a browser UI, a terminal UI built on Bubble Tea, and native desktop and Android/iOS apps. It also covers rankings, official playlist categories, personal playlists after login, and a local music library that reads embedded metadata, covers, and lyrics. Downloads can embed covers and lyrics through FFmpeg and sync to WebDAV.

The core platform integration relies on the music-lib library. Docker images are available, and the Web interface can be mounted under a reverse-proxy sub-path.

Key features

  • 01Searches singles, playlists, and albums across multiple music platforms at once.
  • 02Offers CLI, Web, terminal UI, and desktop app interfaces.
  • 03Supports lossless FLAC on several platforms when cookies are configured.
  • 04Embeds covers and lyrics into downloads when FFmpeg is installed.
  • 05Manages a local music library with metadata scanning and search.
  • 06Syncs downloads to WebDAV and provides Docker images.

Use cases

  • Downloading a specific song or album from several streaming services in one search.
  • Running a self-hosted music download service on a home server or NAS via Docker.
  • Browsing platform rankings and playlists from a terminal.
  • Organizing a local music folder with automatic metadata and lyrics.

Topics

#music#downloader#golang#cli#web#tui#netease-music#self-hosted#go

FAQ

What is go-music-dl?
A Go tool for searching and downloading music from many Chinese and international streaming platforms, via CLI, Web, TUI, or desktop app. Go Music DL is a multi-platform music search and downloader. It aggregates results from more than ten services, including NetEase Cloud Music, QQ Music, Kugou, Kuwo, Migu, Bilibili, Soda Music, and Apple Music, and can search for single tracks, playlists, and albums. Lossless FLAC is supported on several platforms when valid cookies are configured.
Is go-music-dl free to use? What license does it have?
go-music-dl is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is go-music-dl still maintained?
Actively maintained. The last commit to go-music-dl was on Oct 18, 2026.
What can I use go-music-dl for?
Downloading a specific song or album from several streaming services in one search. Running a self-hosted music download service on a home server or NAS via Docker. Browsing platform rankings and playlists from a terminal. Organizing a local music folder with automatic metadata and lyrics.
Where can I get go-music-dl?
The source code and installation instructions are on GitHub: https://github.com/guohuiyuan/go-music-dl

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects