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