guohuiyuan/go-music-dl

The problem

If you want a track that lives on NetEase but whose lossless version sits on QQ Music, you end up juggling several client apps, cookie exports and ad-heavy web players just to get one file. Go Music DL collapses that into a single search box: it queries many Chinese services at once, ranks matches, and lets you pick the source that actually returns a playable, sometimes lossless, file. It also doubles as a local library for the audio you already have.

What's different

Most downloaders in this niche are either a single-platform script or a fragile GUI that breaks with each site change. This one is a Go binary with three front-ends (web, terminal TUI, native desktop) sharing one backend, so it fits a server, a headless machine or a phone. The source-switching logic — fuzzy title/artist match, duration checks, then a playability probe — is the part that saves time when a platform silently returns a 30-second preview instead of the real track. Weightless formats are supported where the platform exposes them, and local files can be indexed as a searchable source alongside remote ones.

Who it's for

People who maintain their own music collection and are comfortable configuring cookies: homelab users who want a self-hosted web player behind a reverse proxy, terminal users who prefer a TUI, and Android users who just want an APK. It is not for anyone expecting a polished streaming service — there is no library-wide recommendation engine or social layer — nor for users who need fully legal, licensed distribution, since the tool relies on third-party platform endpoints and account cookies.

Cost of adoption

The simplest path is Docker Compose, which the README says needs only the compose file and image; a standalone binary and terminal search are also documented. Full-quality downloads often require logged-in cookies, some of which can be obtained by QR scan. FFmpeg is needed for embedded covers, lyrics and local metadata; the Docker image and Android APK bundle it, but CLI and iOS builds need it installed separately. The iOS package is unsigned and must be self-signed, and the project is AGPL-3.0, which matters if you plan to host a modified version publicly. Because it scrapes platform APIs, expect breakage when those services change, and note the README itself warns that cookies are stored locally and should not be shared.

Verdict

This is a young project — created in early 2026 — that is currently on a modest rise, having gained roughly 870 stars in a month and reaching #18 on the Go monthly board. That is real traction but not yet the kind of multi-year history that proves the scrapers survive platform churn. The breadth of features (playlists, charts, lyrics, WebDAV sync, mobile builds) suggests an active maintainer rather than a weekend script, yet all of it rests on undocumented third-party endpoints. If you want a self-hosted, multi-source music tool and can live with cookie maintenance and occasional breakage, it is worth a try; if you need long-term stability or a license-friendly product, look elsewhere.