Skip to content
trtyrPublic

About

Turn Bilibili videos into text — subtitle extraction or local transcription, export Markdown/SRT. Published on crates.io.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

18 Commits

Folders and files

Repository files navigation

bili2text

把 B 站视频变成文字:贴一个链接,拿到一份文档。

Rust platform crates.io license

这是什么 · 30 秒上手 · 它能做什么 · 命令参考 · 已知限制 · 设计文档

$ bili2text https://www.bilibili.com/video/BV17pFLzXEEp/

✓ 职场地图 | 跳槽圣经,打工人如何润的更好?…(AI 字幕(ai-zh) · 527 段)
已保存:职场地图 _ 跳槽圣经….md

这是什么

bili2text 是一个把 B 站视频变成文字的命令行工具。看长视频没时间? 想让播客 / 访谈 / 教程变成可搜索的笔记?贴上链接:

  • 有字幕(官方或 AI)→ 秒回,直接提取成 Markdown
  • 没字幕 → --transcribe 用本地 SenseVoice 模型转写,中文效果优于 Whisper, 不上传任何音频

它是纯 CLI、零常驻服务:登录态、历史记录、转写模型全部留在本机, 一个数据目录 ~/.local/share/bili2text/ 管所有东西,删掉即卸载。

30 秒上手

前置:装好 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 指定输出路径

转写(--transcribe)

  • 没字幕的视频也能转: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 支持前缀)

评论拉取(comments)

  • 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 双许可开源

About

Turn Bilibili videos into text — subtitle extraction or local transcription, export Markdown/SRT. Published on crates.io.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages