# Install ncmdump with Homebrew, MacPorts, winget

Convert Netease Cloud Music ncm files to mp3/flac files. Version 1.5.1 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:ncmdump
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install ncmdump
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install ncmdump
```

  Evidence: MacPorts ports tree: multimedia/ncmdump/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Windows

- winget (92%):

```sh
winget install --id TaurusXin.ncmdump -e
```

  Evidence: Windows Package Manager source index: TaurusXin.ncmdump from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:ncmdump
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/ncmdump>
- **Version:** 1.5.1
- **Source summary:** Convert Netease Cloud Music ncm files to mp3/flac files
- **Homepage:** <https://github.com/taurusxin/ncmdump>
- **Repository:** <https://github.com/taurusxin/ncmdump>
- **Upstream docs:** <https://github.com/taurusxin/ncmdump>
- **License:** MIT
- **Source archive:** <https://github.com/taurusxin/ncmdump/archive/refs/tags/1.5.1.tar.gz>
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- ncmdump (cli)
- ncmdump (alias)

## Dependencies

- taglib

## Build dependencies

- cmake

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.5.1
- Local data: ok
- Upstream repository: https://github.com/taurusxin/ncmdump
- Upstream latest detected: 1.5.1 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

ncmdump is a small C++ command-line converter for NetEase Cloud Music `.ncm` cache files. Its README describes converting downloaded NCM cache files to MP3 or FLAC and the Homebrew formula packages the same purpose.

### Project history

The GitHub repository was created on 2021-10-06. The README says this C++ version was a cross-platform port and reproduction of the earlier anonymous5l/ncmdump project, which the README says had been deleted, and claims it was the earliest C++ version and first program on the market to support NCM conversion. Version 1.3.0 is called out in the README for fixing filenames containing UTF-8 characters such as Chinese, Japanese, Korean, and emoji, and for adding DLL builds for use from other languages.

### Adoption history

ncmdump's adoption is concentrated in the NetEase Cloud Music ecosystem and Chinese-language toolchains. The GitHub page observed for this batch showed about 4.1k stars and 488 forks, while Homebrew, MacPorts, and winget packaging make the CLI available outside ad-hoc binary downloads. The Homebrew formula API response consulted for this July 2026 batch reported 68 install-on-request events in 30 days and 649 in 365 days.

### How it is used

The README documents single-file conversion, multiple input files, directory mode with `-d`, recursive traversal with `-r`, output selection with `-o`, source deletion after successful processing with `-m`, and version/help flags. The maintainer has clarified in GitHub Discussions that the tool decrypts and extracts the original MP3 or FLAC data from the `.ncm` file rather than transcoding between formats.

### Why package nerds care

ncmdump is a format-escape utility: valuable when a user's music files are locked in NetEase's `.ncm` wrapper and they want normal player/library compatibility. It is niche, but the packaging story matters because users often need a trusted binary instead of random converter sites.

### Timeline

- 2021-10-06: GitHub repository created.
- 1.3.0: README notes full UTF-8 filename fixes and DLL build support.
- 2025-10-05: GitHub page observed release 1.5.1 as latest in the rendered releases panel.

### Related projects

- anonymous5l/ncmdump, ncmdump-go, ncmdump-gui, NetEase Cloud Music

### Sources

- <https://api.github.com/repos/taurusxin/ncmdump>
- <https://formulae.brew.sh/api/formula/ncmdump.json>
- <https://github.com/taurusxin/ncmdump>
- <https://github.com/taurusxin/ncmdump/discussions/66>


## Security Notes

infrastructure mutation or orchestration signal.

- **Geiger risk:** orange / medium
- infrastructure mutation or orchestration signal

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** ncmdump
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- MacPorts - ncmdump: normalized package name match | MacPorts ports tree: multimedia/ncmdump/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- winget - TaurusXin.ncmdump: normalized package name match | Windows Package Manager source index: TaurusXin.ncmdump from https://cdn.winget.microsoft.com/cache/source.msix
- winget - xiSage.ncmdump-net: normalized package name match | Windows Package Manager source index: xiSage.ncmdump-net from https://cdn.winget.microsoft.com/cache/source.msix


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [taglib](https://www.automicvault.com/pkg/brew/taglib/) - Runtime dependency declared by Homebrew.
- [cmake](https://www.automicvault.com/pkg/brew/cmake/) - Build dependency declared by Homebrew.
- [shntool](https://www.automicvault.com/pkg/brew/shntool/) - Shares av.db curated category or tags: audio, cli, conversion, media.
- [abcde](https://www.automicvault.com/pkg/brew/abcde/) - Shares av.db curated category or tags: audio, cli, media.
- [adplay](https://www.automicvault.com/pkg/brew/adplay/) - Shares av.db curated category or tags: audio, cli, media.
- [adplug](https://www.automicvault.com/pkg/brew/adplug/) - Shares av.db curated category or tags: audio, cli, media.
- [aften](https://www.automicvault.com/pkg/brew/aften/) - Shares av.db curated category or tags: audio, cli, media.
- [alsa-lib](https://www.automicvault.com/pkg/brew/alsa-lib/) - Shares av.db curated category or tags: audio, cli, media.
- [bandcamp-dl](https://www.automicvault.com/pkg/brew/bandcamp-dl/) - Shares av.db curated category or tags: audio, cli, media.
- [carla](https://www.automicvault.com/pkg/brew/carla/) - Shares av.db curated category or tags: audio, cli, media.
- [kew](https://www.automicvault.com/pkg/brew/kew/) - Both packages work with overlapping file formats or content types. Shared terms: audio, cli, media, music, taglib.
- [rsgain](https://www.automicvault.com/pkg/brew/rsgain/) - Both packages work with overlapping file formats or content types. Shared terms: audio, cli, media, taglib.
- [whatmp3](https://www.automicvault.com/pkg/brew/whatmp3/) - Both packages work with overlapping file formats or content types. Shared terms: audio, cli, flac, media, mp3.

## Combined YAML source

View the package source record on GitHub. [combined/ncmdump.yml](https://github.com/automic-vault/db/blob/main/combined/ncmdump.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
