Skip to content

Latest commit

 

History

History
58 lines (56 loc) · 3.08 KB

File metadata and controls

58 lines (56 loc) · 3.08 KB

QuickPiperAudiobook

English | Polski | 简体中文

只需一条命令即可为任何文本内容生成自然语音的有声读物。

安装

  1. 下载预构建的发行版
    • (或通过 go mod tidy && go build 从源码构建)
  2. 安装 ebook-convert 并确保它在系统 PATH 中(该工具包含在 Calibre 中)
  3. (可选) 安装 ffmpeg 以支持 MP3 和章节功能

Note

无需单独安装 Piper。本程序会自动管理 Piper 及其相关模型

使用方法

  • 输入本地文件路径或带有正确扩展名的远程 URL
    • 示例:./QuickPiperAudiobook test.txt
  • 使用 --chapters 参数为 EPUB 文件生成带章节的 MP3
    • 示例:./QuickPiperAudiobook --chapters test.epub
  • 使用 --help 参数查看所有可用选项
    • 示例:./QuickPiperAudiobook --help

非英语/UTF-8 支持

  • Piper 模型库下载您所需语言的模型文件(.onnx 和 .json)
    • 例如:zh_CN-huayan-medium.onnx 及对应的 zh_CN-huayan-medium.onnx(如需要请重命名)
  • 将它们放置在 ~/.config/QuickPiperAudiobook/ 目录中
  • 使用 --speak-utf-8--model= 参数指定用特定模型处理 UTF-8 字符
    • 示例:./QuickPiperAudiobook --speak-utf-8 --model=zh_CN-huayan-medium.onnx test_chinese_data.pdf

Note

如果您经常使用某个模型,建议在配置文件中将其设为默认模型

配置设置

  • 可以在 ~/.config/QuickPiperAudiobook/ 创建配置文件,以避免每次都需要在命令行指定参数
    • 例如:可以将任意模型的 .onnx.onnx.json 文件放在 ~/.config/QuickPiperAudiobook/ 目录中
    • 完整的配置示例请参考这里
# `~/.config/QuickPiperAudiobook/config.yaml` 示例
# 用户未指定 --output 参数时使用的默认输出目录
output: ~/Audiobooks
# 用户未指定 --model 参数时使用的默认模型
model: "en_US-hfc_female-medium.onnx"
# 是否输出为 MP3 文件(需要 ffmpeg)
mp3: false
# 是否在输出 MP3 时生成章节元数据(需要 EPUB 输入和 ffmpeg)
chapters: false

注意事项

  • Piper 不提供进度输出。由于所有处理都在本地进行,生成长篇有声读物可能需要较长时间。
  • 本项目仅在 Linux 环境下测试过。

支持项目

感谢您考虑支持本项目。 您可以通过 GitHub 或 PayPal 进行捐赠。如需赞助本项目或出于商业目的联系我,请通过电子邮件我的网站与我联系。