# Open Bilibili Downloader

**Repository Path**: LinmengenData/open-bilibili-downloader

## Basic Information

- **Project Name**: Open Bilibili Downloader
- **Description**: 一款功能强大的 哔哩哔哩 视频下载工具，提供直观的图形界面，支持视频和仅音频下载，包含较高兼容性的音轨合并以及完善的下载管理功能。
- **Primary Language**: Python
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/LinmengenData/open-bilibili-downloader
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-28
- **Last Updated**: 2025-10-12

## Categories & Tags

**Categories**: networklib

**Tags**: downloader

## README

# B站视频下载工具

一款功能强大的 **哔哩哔哩** 视频下载工具，提供直观的图形界面，支持视频和仅音频下载，包含较高兼容性的音轨合并以及完善的下载管理功能。

## ✨ 功能特性

- 🎥 **视频/音频下载** - 支持下载B站视频和单独提取音频
- 🖥️ **图形化界面** - 简洁美观的深色主题界面，操作简单直观
- 📊 **任务管理** - 实时显示下载进度，支持暂停/继续和删除任务
- 🔐 **账号登录** - 支持扫码登录，可下载更高分辨率的会员视频
- 📁 **文件管理** - 自动处理文件名特殊字符，支持自定义保存路径
- 🔄 **实时状态** - 侧边栏显示任务统计信息，实时更新下载状态

---

## 📦 安装说明

### 方式一：使用发行版（推荐）
直接从[最新发布版本](https://gitee.com/LinmengenData/open-bilibili-downloader/releases)下载，内置FFmpeg，无需安装Python环境，解压即可使用。

### 方式二：源码运行
1. 确保已安装Python 3.7+
2. 安装所需依赖：
```bash
pip install -r requirements.txt
```
3. 自行安装FFmpeg并添加到系统PATH环境变量

## 🚀 使用方法

1. **启动程序**：
   ```bash
   python main.py
   ```

2. **解析视频**：
   - 在主界面输入B站视频链接
   - 点击"解析链接"按钮获取视频信息

3. **下载设置**：
   - 选择保存路径（默认为程序目录下的downloads文件夹）
   - 自定义文件名（可选）
   - 选择下载类型：视频（含音频）或纯音频

4. **账号登录**（可选但推荐）：
   - 点击侧边栏"账户登录"
   - 使用B站手机APP扫描二维码登录
   - 登录后可下载更高清的视频内容

5. **任务管理**：
   - 在"任务列表"页面查看所有下载任务
   - 支持暂停/继续正在下载的任务
   - 可以删除选中的任务

---

## 🔮 软件预览
![Software Preview](https://gitee.com/LinmengenData/open-bilibili-downloader/raw/master/Preview/软件预览1.png)

---

## 🔒 安全提示

- 扫码登录后会在软件目录生成`cookies.ini`文件
- 该文件包含您的登录凭证，请妥善保管避免泄露
- 建议在个人设备上使用，使用后及时清理cookies文件

---

## ❓ 常见问题 (FAQ)

1.  **问：无法下载或提示错误？**
    *   **答**：请确保您的网络连接正常，并且输入的B站视频链接是有效的。此外，B站接口可能发生变化，可能导致工具暂时失效，请关注项目更新（发行版自**V2.0版本**开始支持自动更新）。

2.  **问：下载的视频没有声音？**
    *   **答**：高清晰度视频通常音视频分离，本工具会自动下载并合并音轨。请确保系统已安装 `FFmpeg` 并将其添加到环境变量中（发行版无需额外安装）。
        *   [FFmpeg 官方下载指南](https://ffmpeg.org/download.html)

3.  **问：支持下载大会员专属视频吗？**
    *   **答**：**支持**。您需要拥有相应的会员权限并在软件中登录您的账户。**本项目不提供任何破解功能。**

4.  **问：软件如何快速更新？**
    *   **答**：**自发行版V2.0版本软件会自动检测新版本并且自动安装更新**，自行编译的版本不支持自动更新（除非使用 **cxFreeze** 打包）

---

## 🤝 贡献指南

我们欢迎任何形式的贡献！包括但不限于：

*   🐛 提交 Bug 反馈
*   💡 提出新功能建议
*   📝 改进代码或文档
*   🔧 修复已知问题

---

## 📄 许可证

本项目采用MIT许可证，详情请参阅LICENSE文件。

---

## ⭐ 致谢

感谢所有为这个项目做出贡献的开发者们！
如果这个项目对您有帮助，请给它一个 ⭐ Star！这是对我们最大的鼓励。