kgg-dec/README.MD

# kgg-dec

酷狗 `kgg` 文件解密工具。

请尽量在下载文件的设备上操作，避免密钥丢失。

## 使用方法 (快捷)

1. 双击 `kgg-dec.exe` 开始解密当前目录。

## 使用方法 (命令行)

1. 启动 `kgg-dec.exe`，其中第一个参数为含有 `kgg` 文件的目录。
2. 你也可以使用 `--` 来将参数后的 `-` 开头的参数视为输入文件或目录。
3. 你可以指定多项输入文件或目录。

### 其它参数

* `--scan-all-file-ext` (可选，`0` 或 `1`): 是否扫描所有文件后缀名。默认为 `0`，只扫描 `kgg` 文件。
* `--db` (可选): 指定 `KGMusicV3.db` 的路径。默认为 `%AppData%/Kugou8/KGMusicV3.db`。
* `--suffix` (可选): 指定解密后文件的后缀。默认为 `_kgg-dec`。

### 使用示例

* `kgg-dec.exe "D:\Music"`: 解密 `D:\Music` 目录下的所有 `*.kgg` 文件。
* `kgg-dec.exe "D:\Music" "D:\KGG\1.kgg"`: 解密 `D:\Music` 目录下的所有 `*.kgg` 文件，以及 `1.kgg`。
* `kgg-dec.exe "D:\Music" --scan-all-file-ext 1`: 尝试将 `D:\Music` 目录下的所有文件视为 `kgg` 文件来解密。
* `kgg-dec.exe "D:\Music" --suffix ""`: 解密后不添加额外的后缀。

指定完参数后可以指定任意数量的文件或目录。

## 错误排查

1. 需要至少播放一次 `kgg` 文件，并确保酷狗能正常播放。
    - 如果还是无效，请尝试使用酷狗重新下载，在同一个设备上进行下载与解密操作。
2. 文件后缀名嗅探代码只支持：`ogg` / `flac`。
    * 其他格式会被识别为 `mp3`。

## 构建

在 Windows 下使用 CMake + Visual Studio 2022 构建。

第一次构建前请到 `third-party/sqlite3` 目录下执行 `fetch_sqlite3.sh`，或手动下载源码放置到对应的位置。

然后就可以利用 CMake 构建了：

```cmd
cmake --preset vs -DCMAKE_BUILD_TYPE=Release
cmake --build --preset vs-release --config Release
copy /y README.MD .\\build\\vs2022\\
```

## 第三方软件

该程序用到了以下第三方软件：

- [SQLite3](https://www.sqlite.org/) (Public Domain)
- [Tiny AES in C](https://github.com/kokke/tiny-AES-c) (Public Domain)
- [MD5.c](https://github.com/freebsd/freebsd-src/blob/release/14.2.0/sys/kern/md5c.c) (from FreeBSD)
    - Derived from the "RSA Data Security, Inc. MD5 Message-Digest Algorithm".