一个功能强大的哔哩哔哩视频字幕下载和处理工具，支持官方字幕提取和自动语音识别。
- 从视频URL或包含URL列表的文件批量下载字幕
- 支持多种字幕格式输出：SRT、ASS、VTT、JSON、TXT、LRC
- 当视频没有官方字幕时，自动使用语音识别生成字幕
- 支持双语字幕处理和对齐
- 字幕清理和优化，包括去除广告、合并相邻时间轴等
- 丰富的配置选项和错误处理机制
- 详细的下载报告和日志
- Python 3.8+
- 克隆或下载本仓库
- 安装依赖库
pip install -r requirements.txt- （可选）配置B站账号Cookie环境变量以访问会员专享内容
# Windows
set BILI_SESSDATA=你的SESSDATA
set BILI_JCT=你的bili_jct
set BILI_BUVID3=你的buvid3
# Linux/Mac
export BILI_SESSDATA=你的SESSDATA
export BILI_JCT=你的bili_jct
export BILI_BUVID3=你的buvid3# 下载单个视频字幕
python enhanced_bilisub.py -i "https://www.bilibili.com/video/BV1xx411c79H"
# 从文件批量下载
python enhanced_bilisub.py -i urls.txt
# 指定输出格式
python enhanced_bilisub.py -i "https://www.bilibili.com/video/BV1xx411c79H" -f srt,ass,vtt
# 使用代理
python enhanced_bilisub.py -i "https://www.bilibili.com/video/BV1xx411c79H" --proxy "http://127.0.0.1:7890"| 参数 | 说明 | 默认值 |
|---|---|---|
-i, --input |
输入源（URL或文件路径） | 必填 |
-o, --output |
输出目录 | output |
-c, --concurrency |
并发请求数 | 3 |
-f, --formats |
输出格式，以逗号分隔，可选: srt,ass,vtt,json,txt,lrc | srt |
--proxy |
代理设置 | 无 |
--use-asr |
无字幕时使用语音识别 | 开启 |
--no-asr |
禁用语音识别 | - |
--asr-model |
语音识别模型 (tiny, base, small, medium, large) | small |
--asr-lang |
语音识别语言 | zh |
--save-audio |
保存临时音频文件 | 关闭 |
- SRT: 最常用的字幕格式，被大多数视频播放器支持
- ASS: 高级字幕格式，支持更多样式和效果
- VTT: Web视频字幕格式，HTML5视频支持
- JSON: 包含详细信息的字幕数据，适合进一步处理
- TXT: 纯文本格式，只包含字幕文本
- LRC: 歌词格式，适合音频文件
本工具使用OpenAI的Whisper模型进行语音识别。模型大小和性能对比：
| 模型 | 参数大小 | 处理速度 | 精度 | 内存占用 |
|---|---|---|---|---|
| tiny | 39M | 极快 | 较低 | 非常小 |
| base | 74M | 快 | 一般 | 小 |
| small | 244M | 中等 | 较高 | 中等 |
| medium | 769M | 慢 | 高 | 大 |
| large | 1550M | 极慢 | 非常高 | 非常大 |
首次运行时会自动下载所需模型文件。对于中文识别，建议至少使用small模型以获得较好效果。
python enhanced_bilisub.py -i "https://www.bilibili.com/video/BV1xx411c79H" -f srt,ass,vtt,txt创建一个urls.txt文件，每行一个视频URL：
https://www.bilibili.com/video/BV1xx411c79H
https://www.bilibili.com/video/BV1Gx411w7sV
https://www.bilibili.com/video/BV1Zx411c7nT
然后执行：
python enhanced_bilisub.py -i urls.txt -c 5python enhanced_bilisub.py -i "https://www.bilibili.com/video/BV1xx411c79H" --asr-model medium- 使用语音识别功能需要下载对应的模型文件，首次运行可能需要较长时间
- 大型模型(medium/large)需要较强的硬件配置
- 对于长视频，处理时间可能较长
- B站对API有请求频率限制，批量下载时建议适当控制并发数
- 若遇到"请求被拒绝"错误，可能是IP被临时封锁，建议使用代理或降低请求频率
biliSub/
├── enhanced_bilisub.py # 增强版主程序
├── bilibiliSub.py # 基础版程序
├── requirements.txt # 依赖库列表
├── README.md # 说明文档
└── output/ # 输出目录
└── temp/ # 临时文件目录
- 首次发布
- 支持官方字幕下载和自动语音识别
- 支持多种字幕格式输出
- 实现批量下载和格式转换
MIT
本项目参考了以下开源项目：