NCMGET
NetEase Cloud
Music Getter

Lightweight, powerful, and type-safe

npm
yarn
pnpm
npm install -g ncmget@latest
NCMGET LogoNCMGET Logo
🎵

Programmatic API

Chainable NCMGET class with search, song, album, artist, playlist, url, lrc, pic — cookie injection, raw mode, and auto-retry built in. Full TypeScript types exported.

💻

CLI Toolkit

Rich commands — serve, search, song, album, playlist, lrc, pic, info, preview. Batch IDs, filename templating, and browser preview out of the box.

🌐

REST API Server

Hono-powered HTTP server with global CORS, per-request NCMGET isolation, Cookie passthrough, and raw response toggle — deploy and query instantly.

🔐

EAPI Encryption

Native NCM EAPI encryption via AES-128-ECB with encrypted-id derivation (XOR + MD5 + Base64). Zero reverse-engineering required.

📥

Streaming Downloads

Queue-based manager with streaming writes, real-time progress bars, auto-retry on failure, filename templating ({name}-{artist}), and illegal-character sanitization.

📝

End-to-End Type Safety

SongData, UrlData, LrcData, SearchOption — strict interfaces covering every API response. Ship with confidence, no any types.