ncmdump is a command-line tool and library that converts Netease Cloud Music ncm cache files to mp3 or flac format.
The tool solves the problem of extracting audio from Netease Cloud Music's proprietary ncm format, which is the cache format used by the platform. It decrypts the ncm files and transcodes them to standard audio formats. The project is a C++ implementation that handles the decryption and metadata extraction from ncm files, including support for filenames containing non-ASCII characters such as Chinese, Japanese, Korean, and emoji symbols.
The tool suits anyone who has downloaded music from Netease Cloud Music and wants to use those files in standard audio players or other applications. It provides both a command-line interface for batch processing and a dynamic library for integration into other applications written in C#, Python, Java, or other languages. The command-line tool supports processing single files, batch processing directories, recursive directory traversal, and custom output directories. For users who need automatic cover art retrieval from the network, the README directs them to alternative implementations written in Go that include this functionality.
The project maintains cross-platform support across Windows, macOS, and Linux with platform-specific build instructions. The tool includes a dynamic library build for Windows that allows calling the conversion functionality from other programming languages.
