把 B 站视频变成文字:贴一个链接,拿到一份文档。
这是什么 · 30 秒上手 · 它能做什么 · 命令参考 · 已知限制 · 设计文档
$ bili2text https://www.bilibili.com/video/BV17pFLzXEEp/
✓ 职场地图 | 跳槽圣经,打工人如何润的更好?…(AI 字幕(ai-zh) · 527 段)
已保存:职场地图 _ 跳槽圣经….md
bili2text 是一个把 B 站视频变成文字的命令行工具。看长视频没时间? 想让播客 / 访谈 / 教程变成可搜索的笔记?贴上链接:
- 有字幕(官方或 AI)→ 秒回,直接提取成 Markdown
- 没字幕 →
--transcribe用本地 SenseVoice 模型转写,中文效果优于 Whisper, 不上传任何音频
它是纯 CLI、零常驻服务:登录态、历史记录、转写模型全部留在本机,
一个数据目录 ~/.local/share/bili2text/ 管所有东西,删掉即卸载。
前置:装好 Rust 工具链。
cargo install bili2text # 即装即用:字幕提取(纯 Rust)
bili2text login # 扫码登录(AI 字幕与高音质下载需要)
bili2text https://www.bilibili.com/video/BV17pFLzXEEp/完成后当前目录会多出一个 <视频标题>.md——头部是视频信息表,
正文是全文。这就是全部流程。
没字幕的视频也想转?换转写版(一条命令覆盖重装,需 cmake):
cargo install bili2text --features transcribe运行时依赖 yt-dlp、ffmpeg 与 SenseVoice 模型(约 230MB)——
缺什么跑 bili2text doctor --fix,能检测并自动补齐。
- 官方字幕优先、AI 字幕兜底,自动挑中文;
--lang可指定语言(如ai-zh、en-US) - 多 P 视频(选集):URL 带
?p=N自动提取对应分 P,-P <n>可强制指定; 标题与时长均以该 P 为准 - 输出 Markdown:头部信息表(来源 / 时长 / 文本来源 / 段落数)+ 全文
--srt同时导出标准 SRT 字幕文件;-o指定输出路径
- 没字幕的视频也能转:yt-dlp 拉音轨 → ffmpeg 转码 → 引擎转写
- 双引擎自动选择(
--asr auto,缺省):配置了远程转写服务则优先远程 (快约 5 倍),不可达自动回落本地;--asr remote/--asr local显式指定 - 本地引擎:SenseVoice(中 / 英 / 日 / 韩 / 粤),全程本机,需转写构建:
cargo install bili2text --features transcribe - 远程引擎:Qwen3-ASR(22 方言 + 热词),任意构建可用。配置二选一:
环境变量
BILI2TEXT_REMOTE_URL/BILI2TEXT_REMOTE_TOKEN,或数据目录remote.json({"url": "...", "token": "..."})
bili2text login:终端直接渲染二维码,B 站 App 扫一下就好bili2text history:提取 / 转写历史落在本机 SQLite,show <id>回看全文,rm <id>删除(id 支持前缀)
bili2text comments <链接>:按热度拉取评论(默认 50 条,-n可调), 存为<标题>.comments.md- 含点赞数、日期、IP 属地与楼中楼预览,公开接口无需登录
- 按错误类别区分退出码(10 输入错误 / 31 无字幕 / 41 yt-dlp 失败…), 完整表见 docs/design.md
- 进度走 stderr,结果摘要走 stdout,产物路径明确打印
bili2text <BV号|链接|短链> 提取字幕,存为 <标题>.md
bili2text <输入> -P <n> 指定分 P(优先于 URL ?p=;缺省 P1)
bili2text <输入> --transcribe 跳过字幕,转写(引擎自动:远程优先,回落本地)
bili2text <输入> --asr <mode> 转写引擎:auto(默认)/ remote / local
bili2text <输入> --srt 同时导出 .srt
bili2text <输入> -o <路径> 指定输出文档路径
bili2text <输入> --lang <lan> 指定字幕语言(如 zh-Hans、ai-zh)
bili2text login 扫码登录 B 站
bili2text status 查看登录态
bili2text logout 清除登录态
bili2text history 历史列表
bili2text history show <id> 回看全文(id 支持前缀)
bili2text history rm <id> 删除记录
bili2text comments <链接> 热门评论存为 <标题>.comments.md
bili2text comments <链接> -n 100 指定拉取条数(默认 50)
输入支持:裸 BV 号、视频页链接、b23.tv 短链(带查询参数也没关系)。
- AI 字幕与高音质下载需要登录——扫码一次 10 秒解决,登录态长期留在本机
- 多 P 视频按单 P 提取:选集视频通过
?p=/-P提取指定 P;逐 P 批量 导出整个合集暂不支持(需求出现再说) - 本地转写是 CPU 实时级:约 0.7-1× 实时速度(M 系芯片),18 分钟视频约 20 分钟;配置远程转写服务后 auto 模式可提速约 5 倍;急用请优先想办法找字幕
- 番剧、课程等非普通视频页暂不支持
cargo build # 构建(轻量,字幕提取)
cargo build --features transcribe # + 本地转写(需 cmake)
cargo test # 单元测试(轻量 18 个 / 转写构建 19 个)
cd e2e && ./.venv/bin/python -m pytest -v # 端到端(Python;转写用例需转写构建,自动跳过)架构、接口调研、退出码设计、数据目录布局等深度内容见
docs/design.md。一句话版:workspace 四个 crate——
bili2text(CLI 应用)+ bili-client / bili2text-downloader /
bili2text-asr(能力库,crates.io 包名带 bili2text- 前缀,库名保持
bili-client / downloader / asr)。
看不完的视频,就变成读得完的文字。
装上试试 · 设计文档 · 提 Issue
以 MIT 或 Apache-2.0 双许可开源