B站视频下载工具 (Bv Servant)

一个简单易用的B站视频下载工具，支持图形界面操作，可以下载B站视频并转换为MP3格式。

✨ 功能特性

• 🎬 视频下载：支持通过BV号下载B站视频
• 📦 分P支持：支持下载多P视频中的指定分P
• 🎵 音频提取：支持将下载的视频转换为MP3格式
• ⚡ 多线程下载：支持多线程并行下载，提高下载速度
• 🖥️ 图形界面：基于PyQt5的友好图形界面
• 📊 进度显示：实时显示下载进度

📋 系统要求

• Python 3.7 或更高版本
• 支持的操作系统：Windows、macOS、Linux

🚀 安装步骤

方法一：使用 Python 运行（推荐开发者）

1. 克隆仓库

git clone https://github.com/Tensofermi/bili_down.git
cd bili_down

2. 安装依赖

使用 pip 安装所需的依赖包：

pip install -r requirements.txt

或者手动安装：

pip install requests tqdm moviepy PyQt5

3. 启动程序

Windows 系统：

python bili_download.py

macOS 系统：

python3 bili_download.py

Linux 系统：

python3 bili_download.py

注意：macOS 和 Windows 上的使用方法基本相同，只是命令可能略有不同（Windows 通常使用 python，macOS/Linux 通常使用 python3）。

方法二：打包成可执行文件（推荐普通用户）

如果你不想安装 Python 环境，可以将程序打包成可执行文件，直接双击运行。

Windows 平台打包

1. 安装 PyInstaller：

pip install pyinstaller

2. 打包程序：

pyinstaller --name=BvServant --onefile --windowed bili_download.py

或者使用提供的打包脚本：

python build_exe.py

3. 运行可执行文件： 打包完成后，在 dist 目录下会生成 BvServant.exe，双击即可运行。

macOS 平台打包

1. 安装 PyInstaller：

pip3 install pyinstaller

2. 打包程序：

pyinstaller --name=BvServant --onefile --windowed bili_download.py

或者使用提供的打包脚本：

python3 build_exe.py

3. 运行可执行文件： 打包完成后，在 dist 目录下会生成 BvServant.app，双击即可运行。

macOS 注意事项：

• 首次运行可能需要在"系统偏好设置 > 安全性与隐私"中允许运行
• 如果遇到权限问题，可以使用命令：xattr -cr dist/BvServant.app

Linux 平台打包

1. 安装 PyInstaller：

pip3 install pyinstaller

2. 打包程序：

pyinstaller --name=BvServant --onefile --windowed bili_download.py

3. 运行可执行文件： 打包完成后，在 dist 目录下会生成 BvServant，运行：

./dist/BvServant

打包选项说明

• --onefile：打包成单个可执行文件
• --windowed：不显示控制台窗口（仅GUI）
• --name：指定生成的可执行文件名称
• --icon：指定图标文件（可选）

打包常见问题

1. 打包文件过大：这是正常的，因为包含了 Python 解释器和所有依赖库
2. 首次运行较慢：可执行文件首次运行需要解压，可能需要几秒钟
3. 杀毒软件误报：某些杀毒软件可能会误报，这是 PyInstaller 打包程序的常见情况，可以添加到白名单

📖 使用方法

使用说明（Windows 和 macOS 使用方法相同）

无论你是在 Windows 还是 macOS 上运行程序，使用方法都是一样的：

1. 输入BV号：在"BV号"输入框中输入要下载的视频BV号（例如：BV1xx411c7mD）
2. 选择分P：如果是多P视频，在"分P号"输入框中输入分P序号（从0开始，默认为0）
3. 选择保存目录：点击"浏览..."按钮选择视频保存位置，或直接输入路径
4. 自定义文件名（可选）：在"文件名"输入框中输入自定义文件名，留空则使用视频标题
5. 转换为MP3（可选）：输入 1 表示下载后自动转换为MP3，输入 0 或留空则不转换
6. 设置线程数：输入并行下载线程数（默认为4，可根据网络情况调整，范围1-16）
7. 开始下载：点击"下载"按钮开始下载

使用示例

• 下载单个视频：输入 BV1xx411c7mD，分P号留空或输入 0
• 下载多P视频的第2P：输入 BV1xx411c7mD，分P号输入 1
• 下载并转换为MP3：输入BV号，在"转换为MP3"输入框中输入 1

跨平台使用说明

Windows 和 macOS 使用差异：

功能	Windows	macOS
启动命令	python bili_download.py	python3 bili_download.py
可执行文件	BvServant.exe	BvServant.app
界面操作	完全相同	完全相同
文件路径分隔符	\	/
默认下载目录	C:\Users\用户名\Downloads	/Users/用户名/Downloads

界面和功能完全相同，只是启动方式略有不同。程序会自动适配不同操作系统的路径格式和文件对话框。

🛠️ 技术栈

• PyQt5：图形用户界面
• requests：HTTP请求处理
• tqdm：进度条显示
• moviepy：视频处理和音频提取
• threading：多线程下载

📝 注意事项

1. BV号格式：请确保输入的BV号以 BV 开头
2. 网络连接：下载需要稳定的网络连接
3. 存储空间：确保有足够的磁盘空间存储视频文件
4. 版权声明：本工具仅供学习交流使用，请遵守B站的使用条款和版权规定
5. MP3转换：转换MP3需要较长时间，请耐心等待

⚠️ 免责声明

本工具仅用于个人学习和研究目的。使用者应当遵守相关法律法规和B站的使用条款，不得用于商业用途或侵犯他人版权。作者不对使用本工具造成的任何后果承担责任。

🐛 问题反馈

如果遇到问题或有改进建议，欢迎提交 Issue 或 Pull Request。

📄 许可证

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

🙏 致谢

感谢所有为本项目做出贡献的开发者和用户。

---

注意：由于B站API可能会发生变化，如果遇到下载失败的情况，可能需要更新代码以适应新的API。