By Bilibili Subtitle Skill
Extract Bilibili subtitles with BBDown and render transcript outputs.
When To Use
Use this skill when a Bilibili video already has downloadable subtitles, including Bilibili AI subtitles exposed by BBDown. This skill only extracts subtitle files exposed by BBDown.
Commands
| Task | Command |
|---|---|
| Preflight | pixi run python -m bilibili_subtitle --check |
| JSON preflight | pixi run python -m bilibili_subtitle --check-json |
| Extract | pixi run python -m bilibili_subtitle "URL" -o ./output |
| Extract JSON | pixi run python -m bilibili_subtitle "URL" -o ./output --json-output |
| Select language | pixi run python -m bilibili_subtitle "URL" --language zh-Hans -o ./output |
Workflow
- Parse the Bilibili URL, BV ID, or av ID.
- Run BBDown in subtitle-only mode.
- Load the downloaded subtitle file.
- Render Markdown transcript, SRT, and VTT files.
- Optionally emit JSON for parent skills.
Outputs
output/
├── {title}.transcript.md
├── {title}.srt
└── {title}.vtt
JSON Contract
pixi run python -m bilibili_subtitle "URL" -o /tmp/output --json-output
The response includes exit_code, output.files, warnings, and errors.
Dependencies
pixifor the Python environmentBBDownfor subtitle extractionghfor installer-driven BBDown nightly downloads
Error Handling
| Code | Level | Meaning | Remediation |
|---|---|---|---|
| E001 | FATAL | BBDown missing | Run ./install.sh |
| E002 | FATAL | BBDown auth required | Run BBDown login |
| E003 | RECOVERABLE | Download failed | Check URL/network/login/language |
| E004 | RECOVERABLE | No downloadable subtitles | Try another language or video |
| E005 | FATAL | Invalid URL/ID | Provide a Bilibili URL, BV ID, or av ID |
| E006 | FATAL | Output write failed | Check output directory permissions |
| E007 | RECOVERABLE | Invalid subtitle content | Retry or inspect BBDown output |