ebook2audiobook

环境要求

• 安装 Docker（GPU 加速需 NVIDIA 驱动并支持 --gpus all）
• 操作系统为 Linux / macOS / Windows
• 准备非 DRM 的合法电子书文件（EPUB、PDF 等）
• 首次运行需下载模型，预留足够磁盘空间与时间

安装与启动步骤

1. 1克隆项目仓库

   把项目下载到本地，并进入项目根目录，后续所有脚本都在此目录执行。

   git clone https://github.com/DrewThomasson/ebook2audiobook.git
   cd ebook2audiobook

   复制

2. 2构建容器镜像

   用项目自带脚本构建镜像。Windows 把命令换成 ebook2audiobook.cmd，Compose 方式加 --docker_mode compose。

   ./ebook2audiobook.command --script_mode build_docker

   复制

3. 3启动 GUI 容器

   挂载电子书、音频、模型、声音和临时目录，映射 7860 端口，启动 CPU 版 Gradio 界面。

   docker run -v "./ebooks:/app/ebooks" -v "./audiobooks:/app/audiobooks" -v "./models:/app/models" -v "./voices:/app/voices" -v "./tmp:/app/tmp" --rm -it -p 7860:7860 athomasson2/ebook2audiobook:cpu

   复制

4. 4GPU 加速启动

   有 NVIDIA 显卡时加 --gpus all，镜像标签按驱动选择 cu118/cu122/cu124/cu126 等。

   docker run -v "./ebooks:/app/ebooks" -v "./audiobooks:/app/audiobooks" -v "./models:/app/models" -v "./voices:/app/voices" -v "./tmp:/app/tmp" --gpus all --rm -it -p 7860:7860 athomasson2/ebook2audiobook:cu126

   复制

5. 5Compose 方式启动

   用 docker compose 拉起 GUI，DEVICE_TAG 指定设备标签，需在项目目录内执行。

   DEVICE_TAG=cu128 docker compose --profile gpu up --no-log-prefix

   复制

6. 6无头模式转换

   不打开网页，直接指定容器内电子书路径批量转换，音频写入挂载的 audiobooks 目录。

   docker run -v "./ebooks:/app/ebooks" -v "./audiobooks:/app/audiobooks" -v "./models:/app/models" -v "./voices:/app/voices" -v "./tmp:/app/tmp" --rm -it -p 7860:7860 ebook2audiobook:cpu --headless --ebook "/app/ebooks/myfile.pdf" --language eng

   复制

7. 7本地命令行运行

   Linux/macOS 用 .command 脚本、Windows 用 .cmd 脚本直接调用，参数含义与容器内一致。

   ./ebook2audiobook.command --headless --ebook ./ebooks/myfile.epub --voice ./voices/myvoice.mp3 --language eng

   复制

关键配置

如何确认成功

浏览器打开 http://localhost:7860 能看到 Gradio 网页界面即为启动成功；无头模式的音频文件会出现在挂载的 audiobooks 目录。

常见问题

注意事项

• 本工具仅用于非 DRM、合法获得的电子书，请勿用于侵权用途。
• Docker 环境不支持 MPS，macOS 只能使用 CPU 镜像。
• 首次运行会下载 TTS 模型，耗时较长且占用较多磁盘空间。
• 运行时务必在项目目录下执行，否则 ./ebooks、./audiobooks 等挂载目录可能不存在。