WhatMP3 技术文档

本文档旨在帮助用户安装、使用 WhatMP3 项目，并详细介绍其功能与配置。

1. 安装指南

在开始安装 WhatMP3 之前，请确保您的系统中已安装以下依赖：

• flac：用于处理 FLAC 文件。
• metaflac：用于处理 FLAC 文件元数据。
• 至少一种编码器（例如 lame、oggenc）。
• 可选：mktorrent 和回放增益工具（例如 vorbisgain）。

以下是安装步骤：

1. 根据您的本地环境，编辑 config.mk 文件（如有必要）。

2. 运行以下命令安装 WhatMP3（如果需要，请以 root 权限运行）：

   make clean install
   

   注意：对于默认安装了 bsdmake 的系统，可能需要安装 gmake。

2. 项目使用说明

WhatMP3 可以将音频文件转码并创建种子文件。以下是如何使用 WhatMP3 的基本说明：

• WhatMP3 会为每个 CPU 核心启动一个并行的转码过程。您可以通过 --threads 参数覆盖此行为。
• 使用 -p 参数创建私有种子文件。

要获取更多帮助信息，可以使用以下命令：

whatmp3 -h

或者查阅手册页面：

man whatmp3

3. 项目 API 使用文档

WhatMP3 的命令行参数如下：

• -r：递归转码目录中的所有文件。
• -z：为零填充的轨道号。
• -o <dir>：指定输出目录。
• -t <url>：指定种子文件的 announce URL。
• --Q8：指定 Ogg Vorbis 的编码质量。
• --V0：指定 MP3 的编码质量。

以下是一个使用示例：

whatmp3 -rz -o ~/tor -t "http://my.tracker/announce" --Q8 --V0 "Svartrit - I" "Svartrit - II"

此命令将在 ~/tor 目录中创建包含 Ogg Vorbis Q8 和 MP3 V0 转码的目录 "Svartrit - I (Q8)" 等，并创建相应的种子文件。

4. 项目安装方式

WhatMP3 的安装方式已在“安装指南”部分中说明。请参考上述步骤进行安装。

---

以上就是 WhatMP3 的技术文档，希望对您的使用有所帮助。如果您在使用过程中遇到任何问题，请查阅文档或寻求技术支持。