# ffbook

**Repository Path**: bsdcpp/ffbook

## Basic Information

- **Project Name**: ffbook
- **Description**: 根据视频和对应字幕制作字幕小人书，一键导出pdf和mobi两种格式文档。
基于FFmpeg、Calibre、Wkhtmltopdf项目。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 1
- **Created**: 2021-03-29
- **Last Updated**: 2025-08-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ffbook

#### 介绍
根据视频和对应字幕制作字幕图画书，一键导出pdf和mobi两种格式文档。

#### 软件架构
本来是一个后台程序，有朋友觉得好玩，就添加一个界面方便使用，程序比较蹩脚，
如有高人帮忙指点改进，不胜感激。

基于FFmpeg、Calibre、Wkhtmltopdf等项目：
1. ffmpeg根据字幕时间戳，截取图片，记录图片和字幕对应关系，生成本地html文件；
2. 用calibre导出kindle格式文档；
3. 用wkhtmltopdf导出pdf。

#### 安装教程

1.  Windows无需安装，下载解压即可，
    链接: https://pan.baidu.com/s/1FCqe07tg9GMJwnTCb-wt9A 密码: fv0j
2.  其他系统安装本项目依赖的FFmpeg、Calibre、Wkhtmltopdf。

#### 使用说明
    以Windows版本为例，其他版本大同小异：

1.  打开main.exe（其他系统可以执行python main.py）
2.  根据提示选择任务数量（任务数多速度会快，但是选择过大可能拖慢电脑，默认为1）
3.  选择视频所在目录，目录不做要求，会搜索所选目录里所有视频文件，符合要求的处理。
    建议一个专辑的剧集放在一个子目录中，这样会生成一个用此子目录名命名的电子书合辑。
4.  产生文档目录暂时不可自定义，都在软件目录的out子目录下。
5.  关注右侧执行日志，有问题请提出。

#### 文件要求：
目前支持'ass', 'ssa', 'srt', 'sub', 'txt', 'vtt'几种字幕
1. 内嵌字幕的视频（非烧写的）；
2. 外挂字幕的文件名必须与视频文件名部分相匹配：
    a. 如Aaa.mp4和Aaa.srt就是完全匹配；
    b. Aaa.en.srt和Aaa.mp4，Aaa.1234.cn.srt和Aaa.mp4都属于部分匹配；
   其实就是取视频的文件名Aaa，然后用通配符Aaa*.srt来匹配字幕。

##### 对原目录结构和文件没有破坏（如果是内嵌字幕的，可能会生成相应字幕文件）

#### 使用截图
<img src="screenshot/main.jpg" alt="ffbook" width="70%;" />
<img src="https://images.gitee.com/uploads/images/2021/0330/201648_f615aa45_8891303.jpeg" alt="ffbook" width="70%;" />
<img src="screenshot/1617022968530.jpg" alt="ffbook" width="70%;" />
<img src="screenshot/1617023876678.jpg" alt="ffbook" width="70%;" />

#### 其他
1.  发现问题请在本站提[issue](https://gitee.com/bsdcpp/ffbook/issues)或联系bsdcpp@gmail.com，感谢；
2.  暂时发现*nix命令行执行，如果图片数量众多，我试过138集，大概3000多张图片会制作出错，需要提高系统限制：ulimit -n unlimited，windows上尚未发现。
3.  后续增加自动辅码，制作点读书；