{
  "markdown": "# bilibili-subtitle\n\nBBDown-only Bilibili subtitle extractor. It downloads Bilibili subtitles with BBDown and renders transcript outputs for downstream skills or local use.\n\n## Features\n\n- Parse Bilibili URLs, BV IDs, and av IDs\n- Download regular or AI subtitles via BBDown\n- Render Markdown transcript, SRT, and VTT outputs\n- Provide JSON output for parent-skill invocation\n- Run preflight checks for BBDown and login state\n\n## Install\n\n```bash\ngit clone https://github.com/HamsteRider-m/bilibili-subtitle.git\ncd bilibili-subtitle\n./install.sh\n```\n\nThe installer prepares the pixi/Python environment and installs the latest BBDown nightly build via `gh`.\n\n## Usage\n\n```bash\npixi run python -m bilibili_subtitle \"BV1xx411c7mD\" -o ./output\npixi run python -m bilibili_subtitle \"https://www.bilibili.com/video/BV...\" --language zh-Hans --json-output\npixi run python -m bilibili_subtitle --check\npixi run python -m bilibili_subtitle --check-json\n```\n\n## Requirements\n\n| Requirement | Purpose |\n| --- | --- |\n| pixi | Python environment |\n| BBDown | Subtitle download |\n| gh CLI | Installer downloads BBDown nightly builds |\n| BBDown login | Recommended for restricted videos |\n\nRun `BBDown login` if downloads fail because of authentication or restricted access.\n\n## Outputs\n\nFor each video, the CLI writes:\n\n- `{title}.transcript.md`\n- `{title}.srt`\n- `{title}.vtt`\n\nWith `--json-output`, stdout contains the stable invocation contract including exit code, generated files, warnings, and errors.\n\n## Parent Skill Invocation\n\n```bash\npixi run python -m bilibili_subtitle \"<URL>\"   -o /tmp/output   --json-output\n```\n\nExit codes:\n\n- `0`: success\n- `1`: fatal configuration/runtime error\n- `2`: recoverable extraction error such as no downloadable subtitles\n\n## Troubleshooting\n\n- `BBDown not found`: run `./install.sh` and ensure `~/.local/bin` is on `PATH`\n- `BBDown authentication required`: run `BBDown login`\n- No subtitle files: confirm the video has downloadable subtitles or try `--language zh-Hans`\n",
  "bytes": 2004,
  "sha": "56727d77d9a785769eee9f910a7ea349698bd7647c91e952e65160906885a76b",
  "repo_slug": "hamsterider-m/bilibili-subtitle",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_hamsterider_m_bilibili_subtitle_bilibili_d785674a/readme"
}