Metadata-Version: 2.4
Name: bbdown
Version: 0.0.1.post1
Summary: BBDown 是一个免费且便捷高效的哔哩哔哩下载与解析工具。
Author: LittleGraper
License-Expression: MIT
License-File: LICENSE
License-File: NOTICE
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Typing :: Typed
Requires-Dist: defusedxml>=0.7.1
Requires-Dist: httpx>=0.28.1
Requires-Dist: protobuf>=7.35.1,<8
Requires-Dist: qrcode[png]>=8.2
Requires-Dist: starlette>=0.48.0
Requires-Dist: uvicorn>=0.35.0
Requires-Python: >=3.12
Description-Content-Type: text/markdown

# BBDown

[![English](https://img.shields.io/badge/lang-English-2563EB)](https://github.com/LittleGraper/BBDown/blob/main/README.md)
[![简体中文](https://img.shields.io/badge/lang-%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87-DC2626)](https://github.com/LittleGraper/BBDown/blob/main/README.zh-CN.md)

[![PyPI](https://img.shields.io/pypi/v/bbdown?label=PyPI&color=3775A9)](https://pypi.org/project/bbdown/)
![Python](https://img.shields.io/badge/Python-3.12%2B-3776AB)
![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-555555)
![CLI](https://img.shields.io/badge/Interface-CLI-7C3AED)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/LittleGraper/BBDown/blob/main/LICENSE)

A free, convenient, and efficient command-line tool for downloading and parsing Bilibili videos.

## Installation

Python 3.12 or later is required. Installation with [uv](https://docs.astral.sh/uv/) is recommended:

```shell
uv tool install bbdown
```

You can also use pip:

```shell
python -m pip install bbdown
```

Install FFmpeg separately to download and mux audio and video. Check your environment with:

```shell
BBDown doctor
```

## Configuration

Most options can be placed in `BBDown.config`, one argument per line:

```text
--work-dir ./downloads
--skip-cover
--download-danmaku
```

Place the file in the current directory or select it with `--config-file`. Command-line arguments override the configuration file.

Scan a QR code to save account credentials when authenticated access is required:

```shell
BBDown login
BBDown logintv
```

## Usage

Pass a BV/AV ID or video URL directly:

```shell
BBDown BV1xx411c7mD
BBDown "https://www.bilibili.com/video/BV1xx411c7mD"
```

View all options and other commands:

```shell
BBDown --help
BBDown serve --help
```

`BBDown`, `bbdown`, and `bbd` are equivalent commands.
