完成Web ASM
This commit is contained in:
Misaki
@@ -1,114 +1,91 @@
|
||||
# ncmdump-go
|
||||
|
||||
基于 https://github.com/taurusxin/ncmdump 的 Golang 移植版
|
||||
基于 [ncmdump](https://github.com/taurusxin/ncmdump) 的 Golang 移植版，支持网易云音乐 `.ncm` 文件解密为 MP3 / FLAC。
|
||||
|
||||
支持网易云音乐最新的 3.x 版本，但需要注意：从 3. x开始的某些网易云音乐版本不再在 ncm 文件中内置封面图片，本项目支持从网易服务器上自动下载对应歌曲的封面图并写入到最终的音乐文件中
|
||||
提供两种使用方式：**Web 图形界面** 和 **命令行工具**。
|
||||
|
||||
你也可以去 https://git.taurusxin.com/taurusxin/ncmdump-gui 下载基于本项目的 gui 可视化图形应用，只需简单点击即可自动转换。
|
||||
## Web 界面（WASM，推荐）
|
||||
|
||||
## 如何提 Issue
|
||||
所有加解密在浏览器本地完成，**不会上传你的文件到任何服务器**。解密引擎使用 Go 编译为 WebAssembly，性能接近原生。
|
||||
|
||||
由于本站恶意机器人注册过多，已关闭账号注册，如果需要提 Issue 请前往 [GitHub](https://github.com/taurusxin/ncmdump)，必须注明 Issue 的主题为 ncmdump-go，敬请谅解。
|
||||
### 使用
|
||||
|
||||
## 安装
|
||||
1. 打开网页
|
||||
2. 选择包含 `.ncm` 文件的**输入文件夹**
|
||||
3. 选择**输出文件夹**
|
||||
4. 点击「开始转换」
|
||||
|
||||
你可以使用去 [releases](https://git.taurusxin.com/taurusxin/ncmdump-go/releases/latest) 下载最新版预编译好的二进制文件，或者你也可以用包管理器来安装
|
||||
歌曲名、歌手、专辑信息以及封面图片会自动写入转换后的文件中。
|
||||
|
||||
> 要求：Chrome / Edge 浏览器，通过 `localhost` 或 HTTPS 访问。
|
||||
|
||||
### Docker 部署
|
||||
|
||||
```shell
|
||||
# Windows Scoop
|
||||
scoop bucket add taurusxin https://git.taurusxin.com/taurusxin/scoop-bucket.git # 添加 scoop 源
|
||||
scoop install ncmdump-go # 安装 ncmdump-go
|
||||
|
||||
# macOS & Linux 之后会支持
|
||||
docker compose up -d --build
|
||||
```
|
||||
|
||||
## 使用方法
|
||||
然后浏览器访问 `http://localhost:8080`。
|
||||
|
||||
使用 `-h` 或 `--help` 参数来打印帮助
|
||||
### 本地开发
|
||||
|
||||
```shell
|
||||
ncmdump-go -h
|
||||
./build-wasm.sh # 编译 WASM + 前端 + 服务器
|
||||
./ncmdump-web --port 8080
|
||||
```
|
||||
|
||||
使用 `-v` 或 `--version` 参数来打印版本信息
|
||||
## 命令行
|
||||
|
||||
### 安装
|
||||
|
||||
```shell
|
||||
ncmdump-go -v
|
||||
go install git.taurusxin.com/taurusxin/ncmdump-go@latest
|
||||
```
|
||||
|
||||
处理单个或多个文件
|
||||
### 使用
|
||||
|
||||
```shell
|
||||
ncmdump-go 1.ncm 2.ncm...
|
||||
```
|
||||
# 单文件
|
||||
ncmdump-go song.ncm
|
||||
|
||||
使用 `-d` 参数来指定一个文件夹，对文件夹下的所有以 ncm 为扩展名的文件进行批量处理
|
||||
|
||||
```shell
|
||||
# 批量处理目录（不递归子目录）
|
||||
ncmdump-go -d source_dir
|
||||
|
||||
# 递归处理 + 指定输出目录
|
||||
ncmdump-go -d source_dir -r -o output_dir
|
||||
```
|
||||
|
||||
使用 `-r` 配合 `-d` 参数来递归处理文件夹下的所有以 ncm 为扩展名的文件
|
||||
### 作为库使用
|
||||
|
||||
```shell
|
||||
ncmdump-go -d source_dir -r
|
||||
```
|
||||
|
||||
使用 `-o` 参数来指定输出目录，将转换后的文件输出到指定目录，该参数支持与 `-r` 参数一起使用
|
||||
|
||||
```shell
|
||||
# 处理单个或多个文件并输出到指定目录
|
||||
ncmdump-go 1.ncm 2.ncm -o output_dir
|
||||
|
||||
# 处理文件夹下的所有以 ncm 为扩展名并输出到指定目录，不包含子文件夹
|
||||
ncmdump-go -d source_dir -o output_dir
|
||||
|
||||
# 递归处理文件夹并输出到指定目录，并保留目录结构
|
||||
ncmdump-go -d source_dir -o output_dir -r
|
||||
```
|
||||
|
||||
## 开发
|
||||
|
||||
使用 go module 下载 ncmdump-go 包
|
||||
|
||||
```shell
|
||||
go get -u git.taurusxin.com/taurusxin/ncmdump-go
|
||||
```
|
||||
|
||||
导入并使用
|
||||
|
||||
```go
|
||||
package main
|
||||
import "git.taurusxin.com/taurusxin/ncmdump-go/ncmcrypt"
|
||||
|
||||
import (
|
||||
"fmt"
|
||||
"git.taurusxin.com/taurusxin/ncmdump-go/ncmcrypt"
|
||||
)
|
||||
|
||||
func main() {
|
||||
filePath := "test.ncm"
|
||||
|
||||
// 创建实例
|
||||
ncm, err := ncmcrypt.NewNeteaseCloudMusic(filePath)
|
||||
if err != nil {
|
||||
fmt.Printf("Reading '%s' failed: '%s'\n", filePath, err.Error())
|
||||
return
|
||||
}
|
||||
|
||||
// 转换格式，若目标文件夹为空，则保存在原目录
|
||||
dumpResult, err := ncm.Dump("")
|
||||
if err != nil {
|
||||
fmt.Printf("Processing '%s' failed: '%s'\n", filePath, err.Error())
|
||||
}
|
||||
if dumpResult {
|
||||
// 使用源文件的元数据修补转换后的音乐文件
|
||||
// 注意：自网易云音乐 3.0 版本开始，ncm 文件中不再内嵌专辑封面图片，参数若为 true 则表示从网易服务器上下载图片并嵌入到目标音乐文件（需要联网）
|
||||
metadata, err := ncm.FixMetadata(true)
|
||||
if !metadata {
|
||||
fmt.Printf("Fix metadata for '%s' failed: '%s'", filePath, err.Error())
|
||||
}
|
||||
fmt.Printf("'%s' -> '%s'\n", filePath, ncm.GetDumpFilePath())
|
||||
}
|
||||
}
|
||||
ncm, _ := ncmcrypt.NewNeteaseCloudMusic("song.ncm")
|
||||
ncm.Dump("/path/to/output")
|
||||
ncm.FixMetadata(true)
|
||||
fmt.Println(ncm.GetDumpFilePath())
|
||||
```
|
||||
|
||||
## 项目结构
|
||||
|
||||
```
|
||||
├── main.go # CLI 命令行入口
|
||||
├── ncmcrypt/ # 核心加解密库
|
||||
│ ├── ncmcrypt.go # NCM 格式解析 / RC4 解密
|
||||
│ ├── metadata.go # 元数据解析（歌名/歌手/封面URL）
|
||||
│ └── embed.go # 内存写入 ID3 / FLAC 标签
|
||||
├── utils/ # AES / 文件工具
|
||||
├── cmd/
|
||||
│ ├── wasm/main.go # WASM 编译入口（浏览器端）
|
||||
│ └── server/main.go # 静态文件服务器
|
||||
├── web/ # 前端（React + Tailwind）
|
||||
└── Dockerfile # 多阶段构建
|
||||
```
|
||||
|
||||
## License
|
||||
|
||||
MIT
|
||||
|
||||
Reference in New Issue
Block a user