# PY-BBDOWN

**Repository Path**: xiaobenniao1012/py-bbdown

## Basic Information

- **Project Name**: PY-BBDOWN
- **Description**: 用Python重写的BBDown项目，用于下载B站视频。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-06-06
- **Last Updated**: 2025-07-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BBDown Python版本

这是一个用Python重写的BBDown项目，用于下载B站视频。

## 技术栈

### 核心功能
- **Python 3.8+**: 项目基础运行环境
- **requests**: HTTP 请求库，用于基础网络请求
- **aiohttp**: 异步 HTTP 客户端/服务器，用于高性能网络请求
- **beautifulsoup4**: HTML 解析库，用于解析网页内容
- **lxml**: 高效的 XML/HTML 解析器
- **pycryptodome**: 加密库，用于处理加密数据

### 命令行界面
- **click**: 命令行界面工具包，用于构建命令行应用
- **rich**: 终端富文本和格式化库，提供美观的命令行输出

### Web 界面
- **FastAPI**: 现代、高性能的 Web 框架
- **uvicorn**: ASGI 服务器，用于运行 FastAPI 应用
- **Jinja2**: 模板引擎，用于渲染 Web 页面

## 功能特点

- 支持下载B站视频
- 支持下载字幕
- 支持下载弹幕
- 支持选择清晰度
- 支持下载会员视频（需要登录）

## 环境要求

- Python 3.8 及以上版本

## 安装方法

### 方法一：从源码安装（推荐）

1. 克隆仓库
```bash
git clone https://gitee.com/xiaobenniao1012/py-bbdown.git
cd py-bbdown
```

2. 安装依赖

```bash
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/
```

## 运行方法

### Web UI 网页版

1. 启动 Web 服务
```bash
cd web
PYTHONPATH=.. uvicorn main:app --host 0.0.0.0 --port 8000 --reload
```
注：可自定义端口，使用 `--port` 参数指定。
注2：PYTHONPATH=.. 可以让python运行环境找到bbdown相关的依赖包

2. 打开浏览器访问
```
http://127.0.0.1:8000/
```

### 命令行使用

基本用法：
```bash
cd py-bbdown
python -m bbdown [视频URL]
```

## 参数说明

- `-q, --quality`: 选择视频质量（如：1080p, 720p, 480p 等）
- `-f, --format`: 选择输出格式（如：mp4, flv 等）
- `-d, --danmaku`: 下载弹幕
- `-s, --subtitle`: 下载字幕
- `--cookie`: 设置cookie（用于下载会员视频）

## 使用示例

```bash
# 下载普通视频
python -m bbdown https://www.bilibili.com/video/BVxxxxxx

# 下载会员视频
python -m bbdown https://www.bilibili.com/video/BVxxxxxx --cookie "your_cookie_here"

# 下载指定清晰度
python -m bbdown https://www.bilibili.com/video/BVxxxxxx -q 1080p

# 下载视频并包含弹幕和字幕
python -m bbdown https://www.bilibili.com/video/BVxxxxxx -d -s
```

## 常见问题

1. 如果遇到权限问题，请确保使用管理员权限运行
2. 下载会员视频时，请确保提供有效的 cookie
3. 如果下载速度较慢，可以尝试使用代理

## 许可证

MIT License