# ncmdump

**Repository Path**: arsrna_admin/ncmdump

## Basic Information

- **Project Name**: ncmdump
- **Description**: netease cloud music copyright protection file dump(golang版本网易云音乐ncm文件格式转换)
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2021-03-28
- **Last Updated**: 2023-10-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ncmdump.go - 导出网易云音乐 NCM 格式

## 简介

用于导出网易云音乐 NCM 格式的相关内容，本项目完全参考 [anonymous5l/ncmdump](https://github.com/anonymous5l/ncmdump)，并使用 golang 实现，起初是为了能在 Windows 下快速编译和运行。有任何BUG在[这里](https://github.com/yoki123/ncmdump/issues)提交。


## 如何使用？

* 使用命令行程序[ncmdump-xxx-release](https://github.com/yoki123/ncmdump/releases)

 
  1. 命令行执行：
  
  `ncmdump-xxx [files.../dirs...]`
  参数支持：
  ```
  --output 输出文件夹，为空时默认输出文件夹为音频文件的原文件夹
  --tag    是否使用ncm的元信息来为音频文件补充tag，默认true
  ```
  参数需要放到输入文件、文件夹之前，如
  `ncmdump-xxx --output=D:\music_dump\ D:\music D:\music\name.ncm`
  
  2. 拖拽执行：
   
   拖拽文件或者文件夹到程序`ncmdump-xxx`上

* 代码中使用

  下载：
  
```shell
  go get -u github.com/yoki123/ncmdump
```

 导入：
```golang
  import "github.com/yoki123/ncmdump"
```

顺便提一句，为了转换以及处理方便，使用 `ncmdump.Dump(fp)` 会将已经解出来的原音乐格式放入内存中，如果想直接写入文件建议修改 writer 的指向即可。

## 格式分析

NCM 实际上不是音频格式是容器格式，封装了对应格式的 Meta 以及封面等信息，主要的格式如下：

![ncm.png](./asserts/ncm.png)

因此，需要解开原格式信息的关键就是拿到 AES 的 KEY，好在每个 NCM 的加密的 KEY 都是一致的（出于性能考虑？）。所以，我们只要拿到 AES 的 KEY 以后，就可以根据格式解开对应的资源。


## 已知问题

新版的云音乐已经不在 NCM 嵌入图片以及 Meta 等信息，因此使用 `ncmdump.DumpMeta` 去调用的时候，需要检查 Meta 信息的完整性。如果您需要 Meta 等信息，建议不要使用最新的客户端。

## 相关链接

- http://www.bewindoweb.com/228.html
- [@anonymous5l](https://github.com/anonymous5l)提供的原版 ncmdump
- [@eternal-flame-AD](https://github.com/eternal-flame-AD)提供的flac封面写入和目录自动寻找ncm文件
- [@mingcheng](https://github.com/mingcheng)提供对ncmdump进行封装

`- eof -`