---
name: bbdown-cli
description: 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.
---

# 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).