Most of the code in this repository was written and developed by AI.
A simple and easy-to-use tool for downloading music from NetEase Cloud Music. Supporting both single songs and albums with multiple ways to use.
- ✨ Support single/multiple song downloads
- 📀 Support full album downloads
- 🚀 Show download progress
- 🎵 Auto-fetch artist and song names
- 📂 Auto-create album directories
- ⚡️ Auto-skip downloaded files
- 🔍 Auto-detect unavailable or copyright-protected songs
- 📝 Auto-download lyrics (if available)
- 🌐 Support proxy configuration
- 🔄 Smart connection handling (try direct connection first, then use proxy if needed)
No installation needed, run directly:
# Download a song
npx netease-music-downloader download 426832090
# Download an album
npx netease-music-downloader album 34836039
# Download with auto proxy (recommended)
npx netease-music-downloader download 426832090 --auto-proxy
# Download with manual proxy
npx netease-music-downloader download 426832090 --proxy http://127.0.0.1:7890The easiest way to use, no installation required. The program will first try a direct connection, and if that fails (which may happen as the GitHub Actions server is located overseas), it will automatically use a proxy to ensure successful downloads:
- Visit Issues page
- Click "New Issue"
- Choose "Download Music" template
- Fill in the type (song/album) and music ID
- Submit the issue and download will start automatically
- Download links will be provided in the issue comments
For local development:
# Clone repository
git clone https://github.com/Gaohaoyang/netease-music-downloader.git
# Enter directory
cd netease-music-downloader
# Install dependencies
pnpm install
# Run commands
pnpm start download 426832090 # Download a song
pnpm start album 34836039 # Download an album
# Run with auto proxy (recommended)
pnpm start download 426832090 --auto-proxy
# Run with manual proxy
pnpm start download 426832090 --proxy http://127.0.0.1:7890- Open NetEase Cloud Music website or client
- Find the song or album you want to download
- Copy the link and get the ID from it:
- Song link:
426832090fromhttps://music.163.com/#/song?id=426832090 - Album link:
34836039fromhttps://music.163.com/#/album?id=34836039
- Song link:
downloads/
├── artist-songname.mp3 # Single song
├── artist-songname.lrc # Lyrics file
└── album-name/ # Album
├── 01.artist-song1.mp3
├── 01.artist-song1.lrc
├── 02.artist-song2.mp3
├── 02.artist-song2.lrc
└── ...
If you're having trouble accessing NetEase Music directly, you can use a proxy in two ways:
The program will first try a direct connection for each song. If that fails, it will automatically find and use an available Chinese proxy:
# Format
pnpm start download <song_id> --auto-proxy
# Example with song download
pnpm start download 426832090 --auto-proxy
# Example with album download
pnpm start album 34836039 --auto-proxyWhen downloading an album, each song will first attempt a direct connection. If a song requires a proxy, it will be used only for that specific song, and the next song will start with a direct connection attempt again.
If you have your own proxy server, you can specify it directly:
# Format
pnpm start download <song_id> --proxy <proxy_url>
# Example with HTTP proxy
pnpm start download 426832090 --proxy http://127.0.0.1:7890
# Example with album download using proxy
pnpm start album 34836039 --proxy http://127.0.0.1:7890Note: When using a manual proxy, prefer using http:// instead of https:// for the proxy URL, as some proxy servers may not properly support HTTPS connections.
- For personal learning use only
- Please comply with relevant laws and regulations
- Some music may be unavailable due to copyright restrictions
- Downloaded music files will be automatically cleaned up after 48 hours
- Stable network connection required
- Special characters in filenames will be automatically removed
MIT