anhe-downloader

Project Overview

Fengbao Music Downloader turns searching, downloading, and tagging a song into one step: after querying multiple sources it writes a complete MP3 with title, artist, album, a 500×500 cover, USLT lyrics, and SYLT synced lyrics (ID3v2.3), ready to display in car stereos or Windows players. It is a lightweight desktop app for Windows 10/11: the Go backend compiles into a single exe of about 9.3 MB, the frontend is embedded via go:embed, and the UI runs on the system's own WebView2 with no Electron or extra browser.

Search once, and what lands on disk is a fully tagged single-file MP3.

Item	Value
Platform	Windows 10/11 (headless mode elsewhere)
Stack	Go + Edge WebView2 + React 18
Size	Single exe, about 9.3 MB
Output	MP3 with ID3v2.3 tags
License	MIT

Key Features

• Multi-source search: QQ Music, NetEase, Kuwo, and Kugou individually, or aggregated with deduplication
• Async streaming downloads: 1~5 concurrent tasks with live progress and speed, temp files plus atomic rename against corruption
• Single-file MP3: title/artist/album, 500×500 APIC cover, USLT lyrics, and SYLT synced lyrics written in one pass
• Playlist import: paste a playlist link to queue tracks in bulk
• Built-in preview: a mini player at the bottom of the download manager to listen before saving
• Source script management: LX Music .js scripts upload, persist, and restore to defaults

Sources & Parsing

• LX source sandbox: scripts run in a simulated globalThis.lx environment, all parsing happens in the local backend to dodge CORS
• Cross-source fallback: Kuwo → Kugou → NetEase matched in order, falling back to built-in parsing when third-party links fail
• VIP blocking: VIP preview placeholder segments are rejected automatically with a prompt to switch sources
• Bring your own scripts: the repo ships no source scripts, place yours in the app directory or upload from settings

Quick Start

1. Download anhe-downloader.exe from Releases into any writable directory and double-click
2. Search for songs and tick the ones you want into the download queue
3. Watch progress in the download manager, finished tracks are ready-to-play MP3s
4. Headless mode: anhe-downloader.exe -headless -port 45678, then open 127.0.0.1:45678 in a browser

System Requirements

Item	Requirement
OS	Windows 10 / 11
Runtime	System-built-in Edge WebView2
Dependencies	No Electron, Node, or extra browser needed

Notes

• Learning use: for personal study and audio-technology research only, content copyrights stay with their owners
• VIP tracks: free endpoints return short previews only, the parser rejects them and asks you to switch sources
• Third-party instability: external link services can fail anytime, the app falls back to built-in parsing without a success guarantee