# Bbdown CLI

> Install and use the BBDown CLI on Linux/macOS for Bilibili downloads, including login/cookies/access_token, downloading by URL, preferring 720p when available, and writing output under a local data/ directory.

- Skill: `xiangyu-cas/bbdown-cli` (Agent Skill)
- Install (CLI): `npx skillmds@latest add xiangyu-cas/bbdown-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xiangyu-cas/bbdown-cli/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: xiangyu-cas (https://skillmd.com/u/xiangyu-cas)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xiangyu-cas/bbdown-cli

---


# BBDown CLI

## Quick start (data/ output, prefer 720p)

- Prefer running from the repo root so `data/` exists.
- List available streams and the exact 720p label:
  - `BBDown --only-show-info <url>`
- Download to `data/` with 720p preference (use the label you saw above):
  - `BBDown --work-dir data -q "<720p label>" <url>`
- If you are unsure about labels, use interactive selection:
  - `BBDown --work-dir data -ia <url>`

## Install or update (Linux/macOS)

- Install via .NET global tool:
  - `dotnet tool install --global BBDown`
- Update:
  - `dotnet tool update --global BBDown`
- Alternative: download a release binary and add it to PATH.

## Dependencies

- Install `ffmpeg` or `mp4box` for muxing.
- For Dolby Vision muxing, use `ffmpeg` 5.0+ or a recent `mp4box`.
- Optional: install `aria2c` if you plan to use `-aria2`.

## Auth and cookies

- Web QR login:
  - `BBDown login`
- TV QR login:
  - `BBDown logintv`
- Use a web cookie string when needed:
  - `BBDown -c "SESSDATA=..." <url>`
- Use TV/APP access token:
  - `BBDown -tv -token "..." <url>`

## Common download workflow

- Basic download:
  - `BBDown --work-dir data <url>`
- Prefer 720p and hide extra streams for cleaner output:
  - `BBDown --work-dir data -q "<720p label>" -hs <url>`
- For multi-part videos, select pages:
  - `BBDown --work-dir data -p 1,3,5 <url>`

## Troubleshooting

- If muxing fails, verify `ffmpeg`/`mp4box` availability or pass explicit paths:
  - `BBDown --ffmpeg-path <path> --work-dir data <url>`
- If member-only content fails, retry with `-c` cookie (web) or `-token` (TV/APP).