QuickPiperAudiobook

环境要求

• Go 环境（使用 go install 或 go build 构建时需要）
• calibre 提供的 ebook-convert 命令，且必须位于系统 PATH 中
• （可选）ffmpeg，用于输出 mp3 和分章节支持
• 无需单独安装 piper，程序会自动管理 piper 及其模型

安装与启动步骤

1. 1获取可执行文件

   三种方式任选其一：下载预编译 release；用 go install 安装；或用 go build 从源码构建。go install 需保证 GOPATH/bin 在 PATH 中。

   go install github.com/C-Loftus/QuickPiperAudiobook@latest

   复制

2. 2安装 ebook-convert

   下载并安装 calibre，它自带 ebook-convert；安装后确认该命令已加入系统 PATH，否则程序无法识别电子书格式。

3. 3安装 ffmpeg（可选）

   只有需要输出 mp3 或为 epub 生成章节时才必须安装。安装后同样确保 ffmpeg 可在命令行直接调用。

4. 4转换本地电子书

   传入本地文件路径即可开始转换，文件扩展名需为程序支持的格式，如 txt、epub、pdf、mobi 等。

   ./QuickPiperAudiobook test.txt

   复制

5. 5生成 epub 章节

   对 epub 文件加上 --chapters 参数，可生成带章节的 mp3 音频；此功能依赖已安装的 ffmpeg。

   ./QuickPiperAudiobook --chapters test.epub

   复制

6. 6查看全部选项

   不确定有哪些可用参数时，用 --help 查看完整选项列表，例如选择声音模型、语速等。

   ./QuickPiperAudiobook --help

   复制

关键配置

如何确认成功

运行 ./QuickPiperAudiobook --help 能正常列出参数说明，说明命令已安装可用；转换完成后会生成对应音频文件。

常见问题

注意事项

• 除使用远程 URL 的情况外，整个转换过程均在本机离线完成，内容不会上传。
• ebook-convert 必须能在终端直接调用，否则请检查 calibre 是否安装及 PATH 配置。
• 非英语内容同样受支持，可在 --help 中查看可用的语言与声音模型选项。