NCMGET
  • English

      • Introduction

      NCMGET is a full-featured command line interface for NetEase Cloud Music. It provides commands for searching, downloading, and viewing music resources directly from the terminal.

      Global Options

      OptionDescription
      -v, --versionDisplay the NCMGET version number
      --helpDisplay help information for any command

      Command Overview

      CommandDescription
      serveStart the HTTP API server
      searchSearch for music, albums, artists, or playlists
      songDownload songs by ID
      albumDownload all songs in an album
      playlistDownload all songs in a playlist
      lrcDownload lyrics for songs
      picDownload cover images for songs
      infoView resource information without downloading
      previewPreview a song in the browser

      Basic Workflow

      The typical NCMGET workflow is: search → download.

      Step 1: Search for a Song

      ncmget search "淘气的Roy"

      This returns a numbered list of matching songs with their IDs.

      Step 2: Download the Song

      Use the ID from the search results:

      ncmget song 3374579108

      Step 3: Download to a Specific Directory

      ncmget song 3374579108 -o ~/Music

      Getting Started