# NCM 自动解码工具

**Repository Path**: haraella/ncm_decoder

## Basic Information

- **Project Name**: NCM 自动解码工具
- **Description**: 一个专注于NCM文件自动解码的开源工具，支持多种格式，简化音乐文件处理流程，提升用户体验。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-16
- **Last Updated**: 2026-06-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# NCM Decoder

网易云音乐 `.ncm` 加密文件自动解密转换工具。监控指定目录，自动将新下载的加密歌曲转为 FLAC 或 MP3 格式，并嵌入封面图片。

## 功能特性

- **批量转换**：启动时自动扫描源目录中所有未转换的 `.ncm` 文件
- **实时监控**：持续监听源目录，新文件下载完成后立即转换
- **并发处理**：多线程并行转换，高效利用系统资源
- **文件稳定检测**：智能等待文件写入完成后再开始转换，避免损坏
- **封面嵌入**：自动提取并嵌入歌曲封面图片
- **后台运行**：通过 VBS 脚本无窗口静默运行，不打扰日常使用

## 环境要求

- Windows 操作系统
- 无需安装 Python 或任何依赖 —— 项目已内置 `.python` 便携运行环境

## 配置说明

编辑 `config.yaml` 进行配置：

| 配置项 | 说明 | 默认值 |
|---|---|---|
| `source_dir` | 监控的源目录（网易云下载目录） | `D:\Music\VipSongsDownload` |
| `target_dir` | 解密后文件输出目录 | `D:\Music` |
| `process_existing` | 启动时是否批量转换已有文件 | `true` |
| `max_workers` | 并发转换线程数 | `4` |
| `stable_seconds` | 文件稳定等待时间（秒），确保下载完成 | `2.0` |
| `log_dir` | 日志文件目录 | `log` |
| `log_max_bytes` | 单个日志文件最大大小（字节） | `10485760`（10 MB） |
| `log_backup_count` | 保留的历史日志文件数量 | `5` |
| `log_level` | 日志级别（DEBUG / INFO / WARNING / ERROR） | `DEBUG` |

## 使用方式

### 双击运行（推荐）

直接双击 `startapp.vbs`，程序将在后台静默运行，不会弹出命令行窗口。

### 命令行运行

```powershell
.python\python.exe main.py
```

按 `Ctrl + C` 可安全退出程序。

## 设置开机自启

将程序添加到 Windows 开机启动项，实现开机自动运行：

1. 按 `Win + R` 打开运行对话框，输入 `shell:startup`，回车
2. 在打开的启动文件夹中，右键 → **新建** → **快捷方式**
3. 在"请键入对象的位置"中，点击 **浏览**，找到本项目的 `startapp.vbs` 文件并选中
4. 点击 **下一步**，为快捷方式命名（如 `NCM Decoder`），点击 **完成**

设置完成后，每次开机系统都会自动在后台启动本程序。

> 如需取消开机自启，删除上述启动文件夹中的快捷方式即可。

## 许可证

本项目基于 MIT 许可证开源。详见 [LICENSE](LICENSE)。