npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2025 – Pkg Stats / Ryan Hefner

netease-music-downloader

v1.5.0

Published

Download music from NetEase Cloud Music

Downloads

197

Readme

NetEase Music Downloader

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.

Features

  • ✨ 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)
  • 📜 Support lyrics-only downloads (without music files)

Usage

1. Use via npx (Recommended)

No installation needed, run directly:

# Download a song
npx netease-music-downloader download 426832090

# Download an album
npx netease-music-downloader album 34836039

# Download lyrics only for a song
npx netease-music-downloader lyrics 426832090

# Download lyrics only for an album
npx netease-music-downloader album-lyrics 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:7890

2. Download via GitHub Issue

The 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:

  1. Visit Issues page
  2. Click "New Issue"
  3. Choose "Download Music" template
  4. Fill in:
    • Type (song/album)
    • Music ID
    • Check "Lyrics only" if you only want to download lyrics
  5. Submit the issue and download will start automatically
  6. Download links will be provided in the issue comments

3. Local Development

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
pnpm start lyrics 426832090   # Download lyrics only for a song
pnpm start album-lyrics 34836039  # Download lyrics only for 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

How to Get Music ID?

  1. Open NetEase Cloud Music website or client
  2. Find the song or album you want to download
  3. Copy the link and get the ID from it:
    • Song link: 426832090 from https://music.163.com/#/song?id=426832090
    • Album link: 34836039 from https://music.163.com/#/album?id=34836039

Download Directory Structure

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
    └── ...

Using Proxy

If you're having trouble accessing NetEase Music directly, you can use a proxy in two ways:

1. Auto Proxy (Recommended)

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-proxy

When 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.

2. Manual Proxy

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:7890

Note: 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.

Notes

  • 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

License

MIT